Skip to main content
POST
Emitir documento

Authorizations

X-Api-Key
string
header
required

Query Parameters

apiKey
object
required
sync
boolean
default:false

Esperar el resultado de la autorización y devolverlo en la respuesta: número, cae y cae_expiration_date, o status ERR con fiscal_status_reason si la autoridad tributaria lo rechaza. Solo Argentina: en otro país responde 400. La espera dura hasta 25 s; si no alcanza, responde PEN como sin este parámetro y el resultado llega por webhook. Enviá external_reference: si cortás la conexión antes y reintentás sin ella, se emite un segundo comprobante.

Body

application/json
branch_office
integer<int32>
required

Código de la sucursal emisora

Example:

0

invoice_type
string
required

Tipo de documento tributario (ej: 33, 39, 61)

Example:

33

invoice_date
string<date>
required

Fecha de emisión del documento

Example:

"2024-03-15"

recipient
object
required

Información del receptor del documento

currency
object
required

Información de la moneda del documento

items
object[]
required

Lista de ítems del documento

totals
object
required

Totales del documento

serie
string

Serie del documento (si aplica)

Example:

"A"

payment_due_date
string<date>

Fecha de vencimiento del pago

Example:

"2024-04-15"

service_start_date
string<date>

Fecha de inicio del período de servicio

Example:

"2024-03-01"

service_end_date
string<date>

Fecha de fin del período de servicio

Example:

"2024-03-31"

service_indicator
integer<int32>

Indicador de servicio (específico por país)

Example:

1

concept
integer<int32>

Concepto del documento (específico por país)

Example:

1

reason_code
string

Código del motivo de anulación (para notas de crédito/débito)

Example:

1

cancellation_date
string<date>

Fecha de anulación del documento

Example:

"2024-03-20"

observations
string

Observaciones adicionales del documento. En Chile se imprimen en el PDF, en un recuadro "Observaciones" y respetando los saltos de línea; no se envían al SII.

Example:

"Pago a 30 días"

external_reference
string

Referencia externa del documento en el sistema del cliente

Example:

"OC-2024-001"

issuer
object

Información del emisor del documento

export_payment_method_code
string

Código del método de pago de exportación (específico para facturas de exportación)

Example:

21

payment_method
object

Método de pago del documento

global_taxes
object[]

Impuestos globales aplicados al documento

billing_reference
object[]

Referencias a documentos relacionados (ej: factura original para notas de crédito)

additional_header_info
object[]

Información adicional en el encabezado del documento

Información adicional en el pie del documento

additional_export_info
object[]

Información adicional de exportación, como lista de pares clave/valor. Las claves transport.* arman el bloque Aduana del DTE chileno y se validan contra el catálogo del país: una clave transport.* desconocida, un valor que no respeta el tipo declarado, un peso o monto en cero o negativo, un peso sin su unidad de medida, o un código fuera de la tabla de Aduana correspondiente (modalidad de venta, cláusula de compraventa, vía de transporte) devuelven 422. Los códigos de país aceptan tanto el ISO 3166-1 alpha-2 como el número de Aduana, y uno que no resuelve también devuelve 422 en vez de viajar al ente. Una exportación de bienes (documentos 110, 111 y 112 sin service_indicator entre 3 y 6) debe declarar ocho claves: transport.sales_modality_code, transport.sales_clause_code, transport.transport_mode_code, transport.port_shipment_code, transport.port_discharge_code, transport.gross_weight, transport.total_packages y transport.packages_type.packages_type_code. Una exportación de servicios no requiere ninguna.

Response

Documento recibido y en procesamiento. O bien, si solo incumple reglas de negocio, registrado con status INV (inválido), number nulo y validation_errors (un elemento por regla incumplida, con field, code y message; los del bloque Aduana llevan el campo additional_export_info.<clave>): no se envía a la autoridad tributaria, no consume folio y no dispara webhook. Para emitirlo, corregí y enviá un documento nuevo; puede reusar el external_reference. La forma de pago se valida contra GET /api/payment-types del país: el código tiene que existir, estar activo (status: "A") y pertenecer al catálogo que corresponde al documento. Los de exportación (FCXC, NDXC, NCXC) exigen una fila con export: true y el campo payment_method.code es obligatorio; los nacionales exigen una con export: false. Con sync=true, el documento en el estado en que quedó al terminar la espera.

id
string

ID único del documento creado

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

branch_office
integer<int32>

Código de la sucursal emisora

Example:

0

serie
string

Serie del documento

Example:

"A"

number
integer<int64>

Número de folio asignado al documento

Example:

1234

invoice_type
string

Tipo de documento tributario

Example:

33

invoice_date
string<date>

Fecha de emisión del documento

Example:

"2024-03-15"

status
string

Estado del documento (ej: PEN, EMS, RCH)

Example:

"PEN"

cae
string

Código de Autorización Electrónica (Chile, Argentina)

Example:

72053234640

cae_expiration_date
string<date>

Fecha de expiración del CAE

Example:

"2024-03-25"

track_id
string

Track ID de seguimiento en el ente tributario

Example:

1234567890

fiscal_status
string

Estado del documento ante la autoridad tributaria (PENDING, ACCEPTED, REJECTED, OBJECTED). Ausente hasta que la autoridad responde: con sync=true llega con el resultado de la autorización

Example:

"ACCEPTED"

fiscal_status_reason
string

Motivo del rechazo u objeción, tal como lo informó la autoridad tributaria

Example:

"10016: El numero de comprobante no es el proximo a autorizar"

validation_errors
object[]

Errores de reglas de negocio. Solo presente cuando el documento se registró con status INV sin enviarse a la autoridad tributaria: no consumió folio y no se va a emitir. Para emitirlo, corregí y enviá un documento nuevo (puede reusar el external_reference).