API BILLBYTE

El API por sus inglas en ingles Application Programming Interface traducido (interfaz de programación de aplicaciones) Es un sistema de múltiples acciones que proveen acceso a diferentes sistemas, independiente del lenguaje de programación. Este sistema permite que múltiples plataformas interactúen con otras sin necesidad que el cliente final o usuario se entere. Si ya cuentas con un software contable, esta herramienta es ideal para ti, permite el envío de documentos a la DIAN y obtención de múltiples respuestas, como los números de rango autorizados, correos electrónicos de respuesta automática, estado actual de tu cuenta, obtención de documentos XML, cantidad de facturas emitidas, documentos XML de prueba y mucho más.

Te presentamos nuestra API V4.0 para facturar electrónicamente con la DIAN (exclusivo para Colombia) podrás vincular tu sistema contable, enviar y recibir peticiones de la forma más sencilla. Contamos con un Demo donde puedes realizar todas las pruebas que desees en el modo de 'habilitación' durante 10 días, pasado este tiempo puedes adquirir tu licencia y entrar en modo 'producción' enviando documentos ilimitados.

Trabajamos para realizar procesos más productivos y menos redundantes.

choose your plan

DOCUMENTACIÓN API

FULL JSON

Usa este JSON para obtener el XML firmado y/o enviar un documento previamente firmado

{
"Enterprise":{
  "Token":"",
  "DocumentNumber":"",
  "DV":"3",
  "Address":"Calle 96",
  "NameSuc":"PRUEBA",
  "CountryId":"170",
  "DepartmentId":"11",
  "MuniID":"11001"
},
"Document":{
  "IdType":"01",
  "Consecutive":"4",
  "Date":"2020-11-01",
  "Time":"10:35:15-05:00",
  "TypeOpe":"09",
  "Currency":"COP"
},
"Response":{
  "URLResponse":"https://stest.billbyte.co/curl/get_fac64.php", 
  "Extra1":"",
  "Extra2":"",
  "PrintResponse":"No" // Yes o No // Imprime la de la petición al lado del Cliente.
},
"Config":{
  "IdParam":"10",
  "IdHeader":"133",
  "IdUser":"1",
  "Software":"Billbyte",
  "Action":"GetXML", // GetXML, Send
  "Ambient":"2"
},
"DownloadAuthorization":{
  "Active":"Inactive",
  "DocumentNumber":"80118411",
  "DV":"3",
  "TypeDocument":null
},
"WithholdingTaxTotal":{
  "Active":"1" //1 = SI, 0 = NO 
},
"Client":{
  "TypePerson":"2",
  "Country":"CO",
  "Municipality":"11001",
  "DocumentNumber":"1015443285",
  "DV":"9",
  "TypeDocument":"13",
  "Department":"11",
  "Address":"Calle 94a 69 40",
  "NameSuc":"SUC1",
  "RUTName":"Javier Castellanos",
  "RUTCountry":"CO",
  "RUTDepartment":"11",
  "RUTMunicipality":"11001",
  "RUTAddress":"Calle 94",
  "RUTTaxes":"01",
  "RUTTaxesName":"IVA",
  "FiscalResp":"",
  "Enrollment":"0",
  "ContactName":"Castellanos",
  "ContactPhone":"111111",
  "ContactMail":"example@example.com",
  "ContactNote":""
},
"PaymentPeriod":{
  "Active":"Inactive",
  "InitDate":"2020-11-01",
  "FinaDate":"2020-11-01"
},
"PaymentMethod":{
  "Active":"Active",
  "MethodCode":"1",
  "MediumCode":"23",
  "ExpirationDate":"2020-11-01",
  "Id":"Cheque bancario"
},
"InvoiceReference":{
  "Active":"Inactive",
  "RefAffected":"",
  "CufeCude":"",
  "Algoritm":"",
  "DateAffected":""
},
"InvoiceReference2":{
  "Active":"Inactive",
  "RefAffected":"",
  "CufeCude":"",
  "Algoritm":"",
  "DateAffected":""
},
"DiscrepancyAnswer":{
  "Active":"Inactive",
  "Ref":"",
  "Code":"",
  "Descr":""
},
"ReferenceOrder":{
  "Active":"Inactive",
  "Code":"",
  "IssueDate":""
},
"ShippingReference":{
  "Active":"Inactive",
  "Id":""
},
"ReferenceReceived":{
  "Active":"Inactive",
  "Id":""
},
"DeliveryTerms":{
  "Active":"Inactive",
  "SpecialTerms":"",
  "LossResponsibilityCode":""
},
"ExchangeRate":{
  "Active":"Inactive",
  "BaseCurrency":"COP",
  "CurrencyToConvert":"COP",
  "Value":null,
  "ConversionDate":null
},
"AddDocRef":{
  "Active":"Inactive",
  "PrefixConsecutive":"SETT4",
  "InitDate":"",
  "ID":""
},
"Advances":[
  {
	 "Active":"Inactive",
	 "Type":"RED3123856",
	 "Value":"1000.00",
	 "DateReceived":"2018-10-01",
	 "DateMade":"2018-09-29",
	 "TimeMade":"23:02:05",
	 "Instructions":"Prepago recibido"
  },
  {
	 "Active":"Inactive",
	 "Type":"RED3123857",
	 "Value":"850.00",
	 "DateReceived":"2018-10-01",
	 "DateMade":"2018-09-29",
	 "TimeMade":"23:02:05",
	 "Instructions":"Prepago recibido"
  }
],
"ProductsServices":[
  {
	 "Active":"Active",
	 "Quantity":"1.000",
	 "UnitQuantity":"94",
	 "UnitValue":"10000.00000000",
	 "Gift":"No",
	 "DeliveryLocationActive":"false",
	 "DeliveryLocationEsqId":"",
	 "DeliveryLocationName":"",
	 "DeliveryLocationData":"",
	 "GiftCode":"",
	 "GiftDiscount":"",
	 "GiftValue":"",
	 "DiscountCharge":"",
	 "IDDiscountCharge":"",
	 "PercentDiscountCharge":"",
	 "DescrDiscountCharge":"",
	 "Mandatary":"",
	 "TDMandatary":"",
	 "DvMandatary":"",
	 "Description":"pruebas",
	 "ProductCodePrefix":"",
	 "ProductCode":"",
	 "QuantityPerPackage":"1",
	 "Brand":"",
	 "Model":"",
	 "SchemeId":"",
	 "SchemeData":"",
	 "SchemeName":"",
	 "Taxes":[
		"01",
		"IVA",
		"19.0000",
		"03",
		"ICA",
		"5.0000",
		"03",
		"ICA",
		"5.0000;94"
	 ],
	 "SellersItemIdentificationID":"",
	 "InformationContentProviderPartyID":""
  }
]
}

JSON RESPONSE XML

Usa este Json para enviar un documento previamente firmado.

{
   "Enterprise":{
      "DocumentNumber":"",
      "DV":"",
      "Token":""
   },
   "Config":{
      "Ambient":"2",
      "IdHeader":"0",
      "IdUser":"1",
      "IdParam":"10",
      "Action":"Sign"
   },
   "Document":{
      "Consecutive":"4"
   },
   "Response":{
      "PrintResponse":"No",
      "Extra1":"",
      "Extra2":"",
      "URLResponse":"https://stest.billbyte.co/curl/get_fac64.php"
   },
   "File":{
      "URLXML":"https://stest.billbyte.co/dian/xml/4113cce3f8907b1f18ea9ae982e5e13b53f4327a987d495f390ea013b8eafe14b6263d471822e26fcf873ac5e8.xml",
      "XML64":"KASDKASDSAIEWEALSDO...",
      "CUXE":"4113cce3f8907b1f18ea9ae982e5e13b53f4327a987d495f390ea013b8eafe14b6263d471822e26fcf873ac58"
   }
}
JSON SIGN

Usa este Json para enviar un documento previamente firmado.

{
   "Enterprise":{
      "DocumentNumber":"",
      "DV":"",
      "Token":""
   },
   "Config":{
      "Ambient":"2",
      "IdHeader":"0",
      "IdUser":"1",
      "IdParam":"10",
      "Action":"Sign"
   },
   "Document":{
      "Consecutive":"4"
   },
   "Response":{
      "PrintResponse":"No",
      "Extra1":"",
      "Extra2":"",
      "URLResponse":"https://stest.billbyte.co/curl/get_fac64.php"
   },
   "File":{
      "URLXML":"https://stest.billbyte.co/dian/xml/4113cce3f8907b1f18ea9ae982e5e13b53f4327a987d495f390ea013b8eafe14b6263d471822e26fcf873ac5e8.xml",
      "XML64":"KASDKASDSAIEWEALSDO...",
      "CUXE":"4113cce3f8907b1f18ea9ae982e5e13b53f4327a987d495f390ea013b8eafe14b6263d471822e26fcf873ac58"
   }
}