Crear Nota Crédito por API (Sector Salud)
Documentación Técnica de la API de DATAICO FACTURA ELECTRÓNICA para el Sector Salud
Referencia técnica de la API de DATAICO para la emisión de Notas Crédito del sector salud.
Referencia completa: API DOCS Documentación Técnica FE
Numeración
Para obtener los datos de tu numeración de Notas Crédito:
Ventas > Notas Crédito > Numeraciones > [Editar]
En la pantalla de edición encontrarás el prefijo, número de resolución y el consecutivo actual.
Crear Nota Crédito a una FE
Método: POST
Endpoint: https://api.dataico.com/direct/dataico_api/v2/credit_notes
Headers:
Content-Type: application/jsonAuth-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 crédito que referencian una factura electrónica (tipo de operación 20). Una nota crédito sin factura referenciada no pasa esa validación.
No envíes sin_factura_referenciada: true. Referencia la factura con invoice_id si la emitiste con Dataico, o con invoice_number, invoice_issue_date e invoice_cufe si la emitiste con otro proveedor.
Estructura JSON
El ejemplo de la nota en la documentación técnica de la API es el de una nota sin datos de salud. Una nota de salud lleva además operation, con el tipo de operación de la factura, y el objeto health, con la misma forma que en la factura (ver Documentación Técnica FE Sector Salud).
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?.