Si te estas integrando por primera vez, puede ser un poco abrumadora la cantidad de enpoints que existen y no saber por donde comenzar. Lo primero, es siempre saber que puedes contar con nuestro equipo de ingenieros en el canal de Slack habilitado, donde podras aclarar todas tus dudas (luego de leer esta documentación, claro esta =P !).Si bien el nivel de integración que se puede alanzar entre un ERP y Febos es muy alto, no es estrictamente necesario y frecuentemente esta limitado solo a las principales acciones relacionadas a la facturación electrónica. En ese sentido, te dejamos una tabla con los principales endpoints que se pueden utilizar, asi como los requerimientos generales antes de poder utilizarlos.7.1. Tu empresa debe existir en Febos#
Lo primero que debes asegurarte, es que tu emprea exista en el ambiente que vas a probar, generalmente es en el ambiente de pruebas puedes asegurarte de esto preguntanos por el canal de chat habilitado. Si eres un partner de Febos, lo ideal es que exista tanto tu empresa, como la de un cliente, para emitir documentos en nombre de él.7.2. Debes tener un token#
Tal como se indica en la sección 3.1. es necesario un token, vuelve a leer esa sección para saber como obtener uno.7.3. Certificados SSL#
En algunos ERP, como SAP, es necesario instalar los certificados SSL del dominio Febos, para la correcta comunicación a través del procolo HTTPS, debes descargar los certificados indicados en la tabla siguiente:7.4. Acceso a la API#
Asegurate de que tienes acceso a la API, esta escucha en el puerto 443 (por seguridad el puerto 80 es redireccionado al puerto 443). Por otro lado, debes recordar que no poseemos IP's fijas, es decir, la IP que responde bajo el dominio de la API el día de hoy, podría no ser la misma el día de mañana.7.5. Principales endpoints#
Si estas aquí por primera vez, seguramente es porque necesitas integrar facturación electrónica. En tal caso, el primer paso debe ser la fabricación del archivo de integración. Este archivo de integración esta descrito en el endpoint de integración. Utiliza el buscador del lado izquierdo e ingresa el texto dtes.nuevo para encontrar toda la información necesaria de acuerdo a la integración.Además de enviar documentos para su integración, te van a interesar los siguientes endpoints, que puedes encontrar utilizando el buscador, ingresando el id de operación de cada endpoint.| ID de operación | Misión |
|---|
| io.documentos.bitacora.listar | Ver el historial de acciones que han ocurrido sobre un documento |
| cl.documentos.listar | Listar documentos electronicos en base a filtros |
| io.documentos.obtener | obtener el xml o pdf de un documento electrónico |
| cl.documento.dte.nuevo | Integrar (emitir) documento |
7.6. Ciclo de emisión#
Para comprender basicamente en que consiste el ciclo de emisión básica de un documento, puedes mirar el siguiente diagrama de secuencia, que intenta mostrar de manera sencilla que es lo que hace cada actor y que sucede tras bambalinas. Modificado en 2025-09-16 19:43:11
