API LaFactura.co:Invoice.ms

De API LaFactura.co
Ir a la navegación Ir a la búsqueda

Objeto:invoice.ms

Es el objeto raiz, del sistema de envio de facturas con complementos del ministerio de salud de nuestra API, es importante respetar todos los elementos aquí contemplados.

Ejemplo
 {
   "invoice.ms":
   {
     "rangeKey":"219832728",
     "issueDate":"20200317",
     "issueTime":"100521",
     "dueDate" : "20200417",
     "paymentType" : "2",
     "paymentCode"  : "1",
     "note1" : "CIENTO TREINTA Y CUATRO MIL DOSCIENTOS CUARENTA PESOS",
     "note2" : "Esta es una nota en la factura",
     "period": {
          "startDate":"20200201",
          "startTime":"010000",
          "endDate":"20200228",
          "endTime":"010000"
     },
     "customer" : {
          "additionalAccountID":"1",
          "name":"Pepito Perez y Compania S.A.",
          "countryName":"Colombia",
          "countryCode":"CO",
          "city":"Bogotá D.C.",
          "countryEntity":"11",
          "countrySubentity":"11001",
          "addressLine":"Av 25 No. 8-47",
          "documentNumber":"900900651",
          "documentType":"31",
          "telephone":"3112196952",
          "email":"[email protected]",
          "emailStyle":"2"
     },
     "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"
         }
      ]
   },
   "additional":{
        "usuarios.ms":[
           {
             "tipoDocumento":"CC",
             "numeroIdentificacion":"51890041",
             "primerApellido":"PEREZ",
             "segundoApellido":"PERALTA",
             "primerNombre":"PEPITA",
             "otrosNombre":"",
             "tipoUsuario":"03"
             "modalidad":"11",
             "tipoPlan":"02",
             "numeroAutorizacion":"202020",
             "poliza":"ABZ-212122",
             "elaboradoPor":"PEPE CARDONA"
           },
           {
             "tipoDocumento":"CC",
             "numeroIdentificacion":"51890042",
             "primerApellido":"PEREZ",
             "segundoApellido":"PERALTA",
             "primerNombre":"PEPITO",
             "otrosNombre":"",
             "tipoUsuario":"01"
             "modalidad":"11",
             "tipoPlan":"01",
             "numeroAutorizacion":"A202020",
             "poliza":"ABZ-212112",
             "elaboradoPor":"PEPE CARDONA"
           }
        ],
        "interoperatividad.ms":{
           "direccion":{
              "URL": "https:/ejemplo.archivos.com"
           }
         }     
     }
 }
Explicacion
Campos
Parámetro Descripción Tipo Obligatorio
rangeKey Identificador único, del rango de facturación a ser usado
Esta valor es el resultado del servicio: Obtener Rangos		 cadena SI
issueDate Fecha de la factura
(YYYYMMDD) Ejemplo: 20200321		 cadena SI
issueTime Hora de facturacion
(HHMMSS) Ejemplo: 175430		 cadena SI
dueDate Fecha de vencimiento
(YYYYMMDD) Ejemplo: 20200421		 cadena SI
paymentType Tipo de pago
Efectivo->1 / Credito->2
Por omisión el sistema supone Credito -> "2"		 cadena NO
paymentCode Medio de pago
Por omisión supone Instrumento No Definido -> "1"
consultar tabla		 cadena NO
note1 Valor de la factura en letras cadena SI
note2 Nota para ser agregada en la factura cadena NO
note3 Nota para ser agregada en la factura cadena NO
note4 Nota para ser agregada en la factura cadena NO
exchangeRate Tasas de cambio
(Solo se requiere cuando se trata de una moneda diferente al Peso Colombiano)
Ir a: exchangeRate		 objeto NO
customer Datos del cliente
Ir a: customer		 objeto SI
amounts Totales del documento
Ir a: amounts		 objeto SI
items Líneas de la factura
(Debe existir almenos una)
Ir a: items		 objeto SI
additional Objeto con elementos complementarios para el sector salud
Objetos:
usuarios.ms
interoperatividad.ms		 objeto SI
Resultados

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

 {
   "invoiceResult":{
       "status":{
          "code":200,
          "text":"Operación realizada con exito"
       },
       "documento":{
          "type":"Factura",
          "mode":"Creation",
          "tascode":"fc-54984309jtr0ret90jjrg",
          "document":"FC-2092092",
          "CUFE":"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

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.

Obtenido de «https://wiki.lafactura.co/index.php?title=API_LaFactura.co:Invoice.ms&oldid=893»