CAcardda
Fiscal Invoice

Get one

Returns a single fiscal invoice (DTE) by its composite id. The response includes the inline issuer and receiver projections (id, name, identifier), the derived tradable and due_date, and the SII event fields (sii_event_state, sii_event_status).

See the id format notes on GET /v1/fiscal_invoices — the id looks like 76123456-7-33-1234 and is a string, not a UUID.

get/v1/fiscal_invoices/{fiscal_invoice_id}

Request

  • Base URL
    https://api.cardda.com
  • URL
    https://api.cardda.com/v1/fiscal_invoices/{fiscal_invoice_id}
  • Auth
    HTTP bearer

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)

Response

Fiscal invoice

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 from an accept/reject event (e.g. ACD, RCD); null until an event is submitted. See POST /v1/fiscal_invoices/{id}/accept_sii_event and /reject_sii_event.

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

Idempotency state of the SII acceptance/rejection lifecycle: idle (default), submitting (event in flight), submitted (recorded).

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)

Changes

No recorded changes to this operation across all 1 revision of this API.