Sign in
latestOpenAPI 3.0.02026-07-2422987517.5 KB

ff1aeb3fda8b

Fiscal Invoice

Accept a received invoice (SII event)

Registers an acceptance event for a received invoice with the SII (Registro de Aceptación/Reclamo). Cardda submits the event synchronously using the company's own approved SII credential, then persists the outcome on the fiscal invoice.

Action codes

action_code is optional; when omitted it defaults to ACD. If provided, it must be one of the accept codes:

CodeMeaning
ACDAceptación del contenido del documento.
ERMOtorga recibo de mercaderías o servicios.
ERGRecibo de mercaderías / servicios (variante).

Idempotency

The event is reserved under a row lock: the invoice moves to sii_event_state: submitting, then submitted on success. A second call while an event is already in flight or recorded returns 409.

Requires the erp_tradables_manage permission on the invoice's own company (checked against the invoice, not the company-id header).

post/v1/fiscal_invoices/{fiscal_invoice_id}/accept_sii_event

Path parameters

fiscal_invoice_idstring required

Composite id of the fiscal invoice, "#{issuer_id}-#{document_type}-#{number}" (e.g. 76123456-7-33-1234). This is a string, not a UUID.

Parameters

#/paths/~1v1~1sii~1keys/get/parameters/0 — unresolved $ref

Request body

action_code'ACD' | 'ERM' | 'ERG'

Accept action code. Defaults to ACD when omitted.

Example request

{
  "action_code": "ACD"
}

Response

The updated fiscal invoice (including sii_event_state, sii_event_status and sii_event_at) plus the raw sii_event_result from the SII.

idstring required

Unique identifier of the fiscal invoice

document_typenumber required

Type of document (e.g. 33 for invoice, 34 for exempt invoice, 39 for electronic receipt)

company_idstring uuid required

ID of the company associated with this invoice

numberstring required

Number of the invoice

issuer_idstring

ID of the entity that issued the invoice, tax identification number for Chilean subjects

receiver_idstring

ID of the entity receiving the invoice, tax identification number for Chilean subjects

issue_type'received' | 'issued' required

Whether the invoice was received or issued by the company

total_amountnumber required

Total amount of the invoice

net_amountnumber

Net amount of the invoice

currencystring

Currency of the invoice (e.g., CLP)

tax_periodstring

Tax period (e.g., MM/YYYY)

expiration_datestring date-time nullable

Expiration date of the invoice

created_atstring date-time

Date and time when the record was synced from IRS

updated_atstring date-time

Date and time when the record was last updated

cancellation_datestring date-time nullable

Date and time when the invoice was cancelled (null if not cancelled)

is_services_invoiceboolean nullable

Whether the invoice corresponds to a services invoice

service_invoice_status'VIG' | 'ANUL' nullable

SII service-invoice acceptance status synced from the upstream document. VIG (vigente) means the document is in force; ANUL (anulado) means it was annulled. Populated only for invoices in the is_services_invoice=true flow; null for other invoices or while the backfill has not yet run.

payment_statusstring nullable

Status of payment (e.g., paid, non_paid)

tradableobject nullable

The ERP payout item (Erp::Payouts::Tradable — a payable, receivable, credit note, etc.) Cardda derives from this invoice, serialized inline via the tradable method. null until a tradable has been created for the invoice.

due_datestring date-time nullable

Payment due date, taken from the linked tradable (tradable&.due_date). null when there is no tradable or it has no due date. Rendered via a serializer method, not a stored column.

sii_event_statusstring nullable

The action the SII recorded for this document (e.g. ACD, RCD), taken from the SII response accion (falls back to the requested action_code).

sii_event_state'idle' | 'submitting' | 'submitted'

Idempotency state of the SII acceptance/rejection lifecycle. After a successful call this is submitted. A row is briefly submitting while the synchronous SII call is in flight (reserved under a row lock so concurrent calls cannot double-submit).

issuer_namestring

Name of the entity that issued the invoice

receiver_namestring

Name of the entity receiving the invoice

raw_xmlstring

Raw XML content of the invoice

counterpart_idstring uuid

UUID of the counterpart Person row Cardda associates with this invoice (the supplier for received invoices, the customer for issued).

issue_datestring date-time required

Date when the invoice was issued

reception_datestring date-time

Date when the invoice was received in the system

iva_amountnumber

IVA (VAT) amount

operationstring

Type of operation (e.g., purchase)

sii_event_atstring date-time nullable

When the SII event was submitted.

sii_event_resultobject

Raw response payload returned by the SII for this event. Shape is passed through as-is; accion holds the accepted/rejected action code.