Ir directamente al contenido
Español
  • No hay sugerencias porque el campo de búsqueda está vacío.

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 u otros destinatarios, el correo sí se envía de nuevo. Cuando la API omite el envío, la respuesta lo indica con "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/json
  • Auth-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:

  1. Usa el método POST para enviar la factura a la DIAN con "send_dian": true y sin enviar al cliente "send_email": false.
  2. De la respuesta de la API extrae: dian_status, CUFE, uuid y qrcode para construir tu representación gráfica.
  3. 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/json
  • Auth-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 name y data (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.
  • email acepta varios correos separados por ; o por ,.
  • El PUT no modifica la factura: solo lee actions. Si el cuerpo no trae el objeto actions, la API toma la raíz del cuerpo como si fuera actions.

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.

Recursos Adicionales