API LaFactura.co:CreditNote
Sumario
Objeto:creditNote
Es el objeto raiz, del sistema de envio de Notas Crédito de nuestra API, es importante respetar todos los elementos aquí contemplados.
Ejemplo
{ "creditNote": { "rangeKey":"219832728", "tascode":"fc-2198920483woepqpwqoie32728", "issueDate":"20200317", "issueTime":"100521", "note1" : "CIENTO TREINTA Y CUATRO MIL DOSCIENTOS CUARENTA PESOS", "note2" : "Este es el motivo de cancelación", "amounts":{ "totalAmount":"120000.00", "discountAmount":"4000.00", "extraAmount":"0.00", "taxAmount":"18240.00", "payAmount":"134240.00" }, "items":[ { "quantity":"5.00", "unitPrice":"20000.00", "total":"96000.00", "description":"Horas de soporte remoto", "brand":"LF", "model":"Soporte", "standard": "999", "agency": "990", "code": "1000", "allowance":[ { "charge":"false", "reasonCode":"11", "description":"Es un super descuento por hoy", "baseAmount":"100000.00", "amount":"4000.00", "percent":"4.00" } ], "taxes":[ { "ID":"01", "taxAmount":"18240.00", "percent":"19.00" } ] }, { "quantity":"1.00", "unitPrice":"20000.00", "total":"20000.00", "description":"Servicio sin IVA", "brand":"LF", "model":"Serv1", "standard": "999", "agency": "990", "code": "1001" } ] } }
Explicacion
Se está solicitando la creación de una factura por una Nota Crédito por el total de $134.240 Pesos, relacionada con una factura que tiene de tascode: fc-2198920483woepqpwqoie32728 con:
Item 1:
- 5 Horas de soporte remoto con un costo unitario de $20.000, para un total de $100.000
- A estas 5 horas se les hizo un descuento del 4% ($4.000), para un total de $96.000
- Se le aplicó el IVA al valor de la línea ($18.240)
Item 2:
- 1 Hora de servicio sin IVA por un valor de $20.000
Totales:
- El total antes de impuestos es de $116.000
- Los impuestos son: $ 18.240
- El total en factura en: $ 134.240
Campos
Parámetro | Descripción | Tipo | Obligatorio |
---|---|---|---|
rangeKey | Identificador único, del rango de facturación a ser usado (Tomado de nuestro sistema) |
cadena | SI |
issueDate | Fecha de la factura (YYYYMMDD) Ejemplo: 20200321 |
cadena | SI |
issueTime | Hora de facturacion (HHMMSS) Ejemplo: 175430 |
cadena | SI |
note1 | Valor de la factura en letras | cadena | SI |
note2 | Motivo la nota crédito emitida | cadena | SI |
note3 | Nota para ser agregada en la factura | cadena | NO |
note4 | Nota para ser agregada en la factura | cadena | NO |
amounts | Totales del documento Ir a: amounts |
objeto | SI |
items | Líneas de la Nota Crédito (Debe existir almenos una) Ir a: items |
objeto | SI |
Resultados
Devuelve un objeto creditNoteResult con el resultado de la operación
{ "creditNoteResult":{ "status":{ "code":200, "text":"Operación realizada con exito" }, "document":{ "type":"Credit Note", "mode":"Creation", "tascode":"fc-2198920483woepqpwqoie32728", "referal":"nc-54984309jtr0ret90jjrg" "document":"NCR-0000002", "CUDE":"43059843095203948093248093483048039248093403298409328490348903483094", "process":0 } } }
A tener presente
- El resultado incluye el campo "tascode", que es el codigo único interno en nuestro sistema e identifica el documento. Es requerido para cualquier acción posterior sobre este documento. (Es importante conservarlo)
- No se debe considerar un documento como válido por la DIAN, hasta que el resultado de una verificación del documento, muestre a process con: 2
Objetos empleados
- exchangeRate (Tasas - Para ventas en Dólares)
- customer (Cliente)
- amounts (Montos)
- items (Lineas de la factura)
Usado por
Los siguientes recursos:
Temas complementarios
Enlaces
- LaFactura.co: https://lafactura.co
- GitHub: https://github.com/FacturacionElectronicaColombia/lafactura.co
Importante
Recuerda que nosotros no te cobramos absolutamente nada por que pruebes nuestra plataforma.
Si deseas tener un usuario y contraseña , comunícate con nosotros.