Ejemplos por país
📄 Ciclo de facturación
Ciclo de vida de la emisión de facturas
Chile tiene un sistema de facturación asíncrono, lo que significa que puede emitir un documento y enviarlo al cliente mientras la autoridad tributaria aún lo está procesando. El efecto es una mayor velocidad y disponibilidad, pero debe manejar correctamente los rechazos de documentos corrigiéndolos y reenviándolos.
Hay 2 pasos de validación: el primero es la validación de envío, donde el certificado y la empresa son verificados por la autoridad tributaria; luego hay una validación de contenido donde el XML es validado.
Los pasos son los siguientes, puede identificarlos usando GET /documents y leyendo los campos.
Consultar documento
1) Borrador
{
"header": {
"document_status" : 0
}
}2) Emitido, pendiente de validación
{
"header": {
"document_status" : 1
}
}El documento tiene todos los campos requeridos y fue emitido por nuestro sistema; será enviado a la autoridad tributaria en unos minutos. No se requiere ninguna acción de su parte.
3) Enviado exitosamente a la autoridad tributaria (SII) y contenido en proceso
{
"header": {
"document_status" : 1,
"taxbureau_send_status": 1,
"taxbureau_send_id": "XXXXXX",
"taxbureau_send_date": "AAAA-MM-DD"
}
}El documento fue enviado automáticamente a la autoridad tributaria. No se requiere ninguna acción de su parte.
3B) Envío rechazado por la autoridad tributaria (SII)
{
"header": {
"document_status" : 1,
"taxbureau_send_status": "XXX"
}
}Error temporal Los códigos de estado de envío del 101 al 110 son errores temporales donde esperaremos 5 minutos y reintentaremos.
No se requiere ninguna acción de su parte en este caso.
Error permanente Los códigos de estado de envío del 201 al 206 son errores permanentes donde no se realizarán más reintentos.
- 201 = Certificado digital no autorizado para enviar documentos
- 202, 203, 206 = Datos enviados incorrectos
- 204 = Certificado digital revocado
- 205 = Empresa no autorizada para enviar documentos
El documento debe ser emitido y enviado nuevamente en este caso.
4) Contenido aprobado por la autoridad tributaria (SII)
{
"header": {
"document_status" : 1,
"taxbureau_send_status": 1,
"taxbureau_send_id": "XXXXXX",
"taxbureau_send_date": "AAAA-MM-DD",
"taxbureau_validation_status": 3
}
}El documento ha completado su ciclo exitosamente, no se requiere ninguna acción adicional.
4B) Contenido aprobado por la autoridad tributaria (SII) con observaciones
{
"header": {
"document_status" : 1,
"taxbureau_send_status": 1,
"taxbureau_send_id": "XXXXXX",
"taxbureau_send_date": "AAAA-MM-DD",
"taxbureau_validation_status": 4,
"taxbureau_validation_comments": "XXXXXX"
}
}El documento fue aceptado pero hubo algunos problemas menores. Encontrará información adicional en el campo de comentarios. No se requiere ninguna acción adicional.
4C) Contenido rechazado por la autoridad tributaria (SII)
{
"header": {
"document_status" : 1,
"taxbureau_send_status": 1,
"taxbureau_send_id": "XXXXXX",
"taxbureau_send_date": "AAAA-MM-DD",
"taxbureau_validation_status": 5,
"taxbureau_validation_comments": "XXXXX"
}
}El documento fue rechazado; encontrará más información en el campo de comentarios.
El documento debe ser emitido y enviado nuevamente en este caso.