Nota Débito por API (Sector Salud)

Referencia técnica de la API de DATAICO para la emisión de Notas Débito del sector salud.

Referencia completa: API DOCS Documentación Técnica FE

Numeración

Para obtener los datos de tu autorización de numeración o consecutivo de Notas Débito:

Ventas > Notas Débito > Numeraciones > [Editar]

En la pantalla de edición encontrarás el prefijo, número de resolución y el consecutivo actual.

Crear Nota Débito a una FE

Método: POST

Endpoint: https://api.dataico.com/direct/dataico_api/v2/debit_notes

Headers:

• Content-Type: application/json
• Auth-token: <token de la cuenta DATAICO>

La nota debe referenciar la factura

En el sector salud, el mecanismo único de validación del Ministerio de Salud solo admite notas débito que referencian una factura electrónica (tipo de operación 30). Una nota débito sin factura referenciada no pasa esa validación.

No envíes sin_factura_referenciada: true. Referencia la factura con invoice_id.

Estructuras JSON disponibles

• Nota Débito para tipo de operación SS_CUFE
• Nota Débito para tipo de operación SS_REPORTE
• Nota Débito para tipo de operación SS_RECAUDO
• Nota Débito para tipo de operación SS_SIN_APORTE

Recibos Referencia (receipt_documents)

Si tu cliente lleva su propio control de recepción de mercancía (un albarán, un DAFI, una guía de remisión), puedes enviar esos identificadores en la solicitud de creación con el campo opcional receipt_documents, un arreglo de textos:

"receipt_documents": ["ALB-4471", "DAFI-9930"]

• Puedes enviar tantos como necesites, y repetir el mismo identificador.
• Si no envías el campo, el documento se crea sin referencias.
• Cada entrada viaja al XML de la DIAN y aparece en el PDF, en el bloque de datos junto a la Orden de Compra.

Es el mismo campo Recibos Referencia que se llena desde la interfaz de Dataico. Ver ¿Cómo agregar Recibos Referencia a una factura o nota?.

Recursos Adicionales

• Documentación Técnica FE Sector Salud