Reenviar Factura Electrónica por API
Documentación Técnica de la API de DATAICO FACTURA ELECTRÓNICA
Referencia técnica de la API de DATAICO para reenviar facturas existentes.
Cuándo sale el correo al cliente. Con
"send_email": true, el correo solo se envía si la factura está aceptada por la DIAN. Si la factura todavía no está aceptada, primero envíala a la DIAN ("send_dian": true).Si el correo ya se envió. La API solo omite un envío idéntico (el mismo documento a los mismos destinatarios, incluidos los adicionales) pedido dentro de los 30 segundos siguientes a otro. Pasado ese tiempo, o con otro
"email_already_sent": true.
Reenviar a la DIAN una factura con estado DIAN_NO_ENVIADO
Método: PUT
Endpoint: https://api.dataico.com/direct/dataico_api/v2/invoices/{uuid}
Reemplaza {uuid} con el identificador único de la factura. Ejemplo:
https://api.dataico.com/direct/dataico_api/v2/invoices/018f1028-2419-835d-8165-accc94ef26ad
Headers:
Content-Type: application/jsonAuth-token: <tu llave API o el Auth Token de la cuenta>
Body:
{
"actions": {
"send_dian": true,
"send_email": true
}
}
Enviar Factura al Cliente con Representación Gráfica Personalizada
Procedimiento:
- Usa el método POST para enviar la factura a la DIAN con
"send_dian": truey sin enviar al cliente"send_email": false. - De la respuesta de la API extrae:
dian_status,CUFE,uuidyqrcodepara construir tu representación gráfica. - Usa el método PUT para enviar la factura al cliente con tu representación gráfica en formato Base64:
Método: PUT
Endpoint: https://api.dataico.com/direct/dataico_api/v2/invoices/{uuid}
Body:
{
"actions": {
"send_dian": false,
"send_email": true,
"email": "cliente@gmail.com",
"pdf": "Base64"
}
}
Nota: El valor del campo pdf debe ser la representación gráfica de la factura codificada en Base64.
Enviar Factura al Cliente con Documentos Adjuntos
Método: PUT
Endpoint: https://api.dataico.com/direct/dataico_api/v2/invoices/{uuid}
Headers:
Content-Type: application/jsonAuth-token: <tu llave API o el Auth Token de la cuenta>
Body:
{
"actions": {
"send_dian": true,
"send_email": true,
"email": "cliente@gmail.com",
"attachments": [
{
"name": "nombre_documento.pdf",
"data": "Base64"
}
]
}
}
Qué recibe el cliente y límites
- El cliente recibe un solo archivo ZIP con el PDF (el tuyo, si enviaste
pdf; si no, el de Dataico), el XML de la DIAN y los adjuntos. - Cada adjunto lleva
nameydata(el archivo en Base64). No hay tope de cantidad de adjuntos, pero la petición completa no puede superar 10 MB: el Base64 pesa cerca de un tercio más que el archivo original. emailacepta varios correos separados por;o por,.- El
PUTno modifica la factura: solo leeactions. Si el cuerpo no trae el objetoactions, la API toma la raíz del cuerpo como si fueraactions.
Mensajes que puede devolver:
| Mensaje | Causa |
|---|---|
El PDF que enviaste en acciones es inválido. Tiene que estar codificado en base 64. |
pdf no es Base64 válido |
Los 'attachments' tienen que ser lista con mapas de esta forma: {"file-str": ... |
attachments no es una lista de objetos con name y data. El mensaje nombra file-str, pero el campo que se lee es data |
Lo mismo vale para el PUT de las notas (/credit_notes/{uuid} y /debit_notes/{uuid}). El documento soporte no tiene PUT.