Notas de débito
Incrementá el valor de una factura de tu emisor con un contrato fiscal tipado.
POST /v1/emitters/{emitter_id}/documents/notas-debitoUna nota de débito suma valor a una factura ya emitida por el mismo emisor:
por ejemplo, el recupero de un costo o de un gasto, o un ajuste de precio.
Tiene el mismo contrato que la nota de crédito, con
nota_debito en lugar de nota_credito: receptor, ítems, moneda, montos
(ver Montos, IVA y pagos), código de
seguridad, fecha de emisión e idempotencia como en la factura, y
documento_asociado obligatorio.
{
"external_id": "recupero_logistica_77",
"idempotency_key": "recupero_logistica_77_v1",
"nota_debito": {
"establecimiento": "001",
"punto": "001",
"moneda": "PYG",
"motivo_emision": "recupero_costo",
"documento_asociado": {
"tipo": "electronico",
"cdc": "01444444017001001000000122026100113640529815"
},
"cliente": {
"ruc": "88899990-9",
"tipo_contribuyente": 2,
"razon_social": "Cliente de prueba"
},
"items": [
{
"descripcion": "Recupero de costo logístico",
"cantidad": 1,
"precio_unitario": 45000,
"tasa": 10
}
]
}
}El CDC y el RUC del ejemplo son ficticios: el CDC es el de una factura del
emisor 44444401-7, el RUC de ejemplo del Manual Técnico v150. Usá el CDC de
tu factura y su mismo receptor.
Documento asociado
Valen las mismas reglas que en la
nota de crédito: un solo
documento_asociado, que tiene que ser una factura de tu emisor, electrónica
(CDC que empieza con 01) o impresa (tipo_documento_impreso: 1), que
exista en SIFEN y no esté cancelada, con el mismo receptor y la misma moneda
que la nota. KilaSifen todavía no lo controla al crear: SIFEN rechaza la nota
con 2403, 2404, 2414, 2434, 2438, 2439, 2441 o 2442. El tope de la suma
frente al total de la factura (2417) es sólo para las notas de crédito. Sobre
una factura innominada, en cambio, KilaSifen exige su nominación y el receptor
nominado, igual que en la nota de crédito.
Emití la nota cuando la factura ya esté approved o
approved_with_observation.
Motivo de la nota
motivo_emision (E401) usa la misma tabla que la
nota de crédito y es obligatorio
en el XML, sin valor por defecto en el Manual Técnico. Elegí el que describe
la operación, por ejemplo recupero_costo (6), recupero_gasto (7) o
ajuste_precio (8). Si lo omitís, KilaSifen informa 1 («Devolución y
Ajuste de precios»): envialo siempre. Un valor fuera de la tabla deja la nota
failed cuando el worker arma el XML.
Receptor, numeración e idempotencia
- El
clientesigue las reglas del receptor de la factura y tiene que ser el receptor de la factura asociada. Una nota de débito no admite un receptor innominado (documents.cliente.innominado_not_allowed, validación 1331 de la NT 23). - No envíes
condicion_operacionnitipo_transaccion: una nota no los lleva en el XML (Manual Técnico v150, E600 y D011; NT 06), aunque untipo_transaccionfuera de 1 a 13 igual deja la notafailed. - Cada tipo de documento tiene su propio correlativo por establecimiento y punto: la primera nota de débito es la número 1 aunque ya haya facturas o notas de crédito.
- El replay con la misma
idempotency_keyy la misma intención devuelve el documento y el job originales (200); un payload distinto con la misma clave responde409 documents.idempotency_key_conflicty no genera una segunda nota.external_ideidempotency_keyson únicos por emisor entre todos los tipos de documento (ver Facturas).