API LaFactura.co:CreditNote
Sumario
Objeto:creditNote (Nota Crédito)
Es el objeto raiz, del sistema de envio de Notas Crédito de nuestra API, es importante respetar todos los elementos aquí contemplados.
*Importante: Tenemos un método muy sencillo y corto para hacer Anulaciones de Factura: Anular Factura
Ingreso:
https://***.tas-la.com/facturacion.v30/creditNote/
(solicita tu usuario y contraseña +57-601-7466664)
Ejemplo
{
"creditNote":
{
"rangeKey":"219832728",
"tascode":"fc-2198920483woepqpwqoie32728",
"intID":"98239",
"issueDate":"20200317",
"issueTime":"100521",
"discrepancyCode":"1",
"note1" : "CIENTO TREINTA Y CUATRO MIL DOSCIENTOS CUARENTA PESOS",
"note2" : "Devolucion parcial por el servicio prestado",
"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 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 de la Nota crédito: $ 134.240
Campos
| Parámetro | Descripción | Tipo | Obligatorio | API |
|---|---|---|---|---|
| rangeKey | Identificador único, del rango de facturación o Documento Ajuste Soporte a ser usado Esta valor es el resultado del servicio: Obtener Rangos |
cadena | SI | v3.0 |
| tascode | Identificador de la factura / Documento Soporte a la que hace relación en nuestro sistema | cadena | SI | v3.0 |
| intID | Identificador único del documento en tu Base de datos | cadena | SI | v3.0 |
| issueDate | Fecha de la factura (YYYYMMDD) Ejemplo: 20200321 |
cadena | SI | v2.0 / v3.0 |
| issueTime | Hora de facturacion (HHMMSS) Ejemplo: 175430 |
cadena | SI | v2.0 / v3.0 |
| discrepancyCode | Código del motivo de la discrepancia 1 -> Devolucion parcial de bienes y/o no aceptacion parcial del servicio 2-> Anulacion de factura electronica 3-> Rebaja o descuento parcial o total 4-> Ajuste de precio 5 -> Otros |
cadena | SI | v3.0 |
| note1 | Valor de la factura en letras | cadena | SI | v2.0 / v3.0 |
| note2 | Motivo la nota crédito emitida | cadena | SI | v2.0 / v3.0 |
| note3 | Nota para ser agregada en la factura | cadena | NO | v2.0 / v3.0 |
| note4 | Nota para ser agregada en la factura | cadena | NO | v2.0 / v3.0 |
| emailStyle | Método de envío del correo al cliente final Por omisión tendrá el mismo de la factura original 0->Enlace de descarga (Por omision) 1->Como archivos adjuntos 2->Acrhivos adjuntos y Asunto homologado DIAN 99->No se envia correo (Eliminado en v3.0) -Si se envia será ignorado- / El sistema enviará por el método que utilizó la factura original |
cadena | NO | v2.0 |
| amounts | Totales del documento Ir a: amounts |
objeto | SI | v2.0 / v3.0 |
| items | Líneas de la Nota Crédito (Debe existir almenos una) Ir a: items |
objeto | SI | v2.0 / v3.0 |
Notas para migrantes de API v2.0 a v3.0:
- Ahora se requiere el discrepancyCode
- Se agregó el intID, que funciona igual que en invoice
- emailStyle se eliminó
- los objetos de amounts e items, fueron ampliados y mejorados
Resultados
Devuelve un objeto invoiceResult con el resultado de la operación
{
"invoiceResult":{
"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
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.
