Acciones sobre un documento
Reintentar, enviar por correo y anular — las tres cosas que puedes hacerle a un documento después de emitirlo.
Reintentar
Para un documento en failed — se acabaron los folios, venció el certificado, el SII estaba caído.
curl -X POST https://api.facturia.cl/v1/documents/doc_01K2R7.../retry \
-H "Authorization: Bearer $FACTURIA_KEY" -H "Facturia-Empresa: $EMPRESA"Reutiliza el folio ya asignado. Nunca crea un segundo documento.
Enviar por correo
curl -X POST https://api.facturia.cl/v1/documents/doc_01K2R7.../send \
-H "Authorization: Bearer $FACTURIA_KEY" -H "Facturia-Empresa: $EMPRESA" \
-H "Content-Type: application/json" \
-d '{"to":["[email protected]"],"attach":["pdf","xml"]}'Si prefieres que salga solo cuando el documento llegue a accepted, pon email_document_to en el
receptor al emitir y no llames a este endpoint.
Anular un documento
Trampa
En Chile no existe «borrar una factura»
Anular es emitir una nota de crédito que referencia el original con código 1. Este endpoint de
conveniencia la emite por ti, pero el resultado es un documento nuevo, con su propio folio, y el
original queda en la historia para siempre. No hay un DELETE que lo haga desaparecer, y no lo va a
haber.
curl -X POST https://api.facturia.cl/v1/documents/doc_01K2R7.../credit_note \
-H "Authorization: Bearer $FACTURIA_KEY" -H "Facturia-Empresa: $EMPRESA" \
-H "Idempotency-Key: $(uuidgen)" -H "Content-Type: application/json" \
-d '{"code":1,"reason":"Anula factura por acuerdo comercial"}'El endpoint devuelve un document nuevo (tipo 61) y enlaza ambos: el original gana annulled_by y
la nota lleva references[0].
code: 2 (corrige texto) y code: 3 (corrige montos) también se aceptan; con code: 3 pasas
items con los montos corregidos.
Lo que no existe
- No hay
PATCHde un documento emitido. Un DTE aceptado es un registro tributario. - No hay
DELETE. Ver arriba. - No hay «reenviar al SII» distinto de
retry: si el documento está enrejected, el folio se quemó y lo que corresponde es emitir uno nuevo con los datos corregidos.