API LaFactura.co:CreditNote

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/

Ejemplo

---

 {
   "creditNote":
   {
     "rangeKey":"219832728",
     "tascode":"fc-2198920483woepqpwqoie32728",
     "intID":"98239",
     "issueDate":"20200317",
     "issueTime":"100521",
     "dicrepancyCode":"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 a ser usado Esta valor es el resultado del servicio: Obtener Rangos	cadena	SI	v2.0 / v3.0
tascode	Identificador de la factura a la que hace relación en nuestro sistema	cadena	SI	v2.0 / 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

• amounts (Montos)
• items (Lineas de la factura)

Usado por

Los siguientes recursos:

• Generar Nota Crédito

Temas complementarios

• Nota Crédito

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.