API LaFactura.co:DebitNote

Objeto:debitNote (Nota Débito)

Es el objeto raiz, del sistema de envio de Notas Débito de nuestra API, es importante respetar todos los elementos aquí contemplados.

    Ingreso:     
    https://***.tas-la.com/facturacion.v30/debitNote/
     
    Solicita tu usuario y contraseña +57-601-7466664
    No cobramos por el proceso de pruebas o desarrollo
    Y puedes empezar inmediatamente (sin certificados o papeleos)

Ejemplo

---

 {
   "debitNote":
   {
     "prefix":"ND",
     "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 Débito 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 débito: $ 134.240
  
  

Campos

---

Parámetro	Descripción	Tipo	Obligatorio	API
prefix	Prefijo del rango de Notas Débito que deseas utilizar. La lista de disponibles la puedes consultar con el servicio: Obtener Rangos	cadena	SI	v3.0
rangeKey	Identificador único, del rango de notas débito a ser usado Esta valor es el resultado del servicio: Obtener Rangos	cadena	SI	v3.0
tascode	Identificador de la factura 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 del documento (YYYYMMDD) Ejemplo: 20200321	cadena	SI	v3.0
issueTime	Hora del documento (HHMMSS) Ejemplo: 175430	cadena	SI	v3.0
discrepancyCode	Código del motivo de la discrepancia 1 -> Intereses 2-> Gastos por cobrar 3-> Cambio del valor 4-> Otros	cadena	SI	v3.0
note1	Valor del documento en letras	cadena	SI	v3.0
note2	Motivo de la nota débito emitida	cadena	SI	v3.0
note3	Nota para ser agregada en la factura	cadena	NO	v3.0
note4	Nota para ser agregada en la factura	cadena	NO	v3.0
amounts	Totales del documento Ir a: amounts	objeto	SI	v3.0
items	Líneas de la Nota Débito (Debe existir almenos una) Ir a: items	objeto	SI	v3.0
additional	Objeto con elementos complementarios Relaciona elementos específicos para algunos clientes especiales Objetos: documento_gn (Requerido para usuarios que manejan su consecutivo de notas débito)	objeto	NO	v3.0

Notas para migrantes de API v2.0 a v3.0:

---

• Este sevicio es nuevo
  

Resultados

---

Devuelve un objeto invoiceResult con el resultado de la operación

 {
   "invoiceResult":{
       "status":{
          "code":200,
          "text":"Operación realizada con exito"
       },
       "document":{
          "type":"DebitNote",
          "mode":"Creation",
          "tascode":"fc-2198920483woepqpwqoie32728",
          "referal":"nd-54984309jtr0ret90jjrg"
          "document":"NDE-0000005",
          "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.