{"info":{"_postman_id":"39fda04d-20f9-463d-bf81-4d58b69c998d","name":"API Compradores","description":"

La API Fibbo está organizada en torno a REST. Nuestra API tiene URL predecibles orientadas a los recursos, acepta cuerpos de solicitud codificados por formulario, devuelve respuestas codificadas por JSON y utiliza códigos de respuesta HTTP, autenticación y verbos estándar. Todas las cuentas tienen por default el modo de conexión con terceros desactivados.

Puedes descargar la documentación de Webhook en el siguiente enlace: https://bit.ly/3znnlCp

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"16840870","collectionId":"39fda04d-20f9-463d-bf81-4d58b69c998d","publishedId":"2sAYX8HLon","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-02-06T23:21:44.000Z"},"item":[{"name":"Autenticación","item":[{"name":"Login","id":"ec8dcb94-1a43-43d8-ab21-c0aec3b6e2f9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"{{BUYER_EMAIL}}\",\n \"password\": \"{{BUYER_PASSWORD}}\"\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/api/{{VERSION}}/login/","description":"

Para realizar las pruebas con otra herramienta como lo es postman escribimos el url en su\nseccion correspondiente, luego de eso nos vamos a la seccion de body, una vez ubicados en\nesa seccion seleccionamos la opcion de form-data la cual nos permitira agregar los parametros\nque necesitemos para poder acceder al servicio el cual es email y password una vez realizada\nla solicitud nos dara los tokens de access y refresh el token que estaremos usando sera el de\nrefresh

\n","urlObject":{"path":["api","{{VERSION}}","login",""],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[{"id":"7d37a0b1-3e68-4f39-bfd2-a39577bf5bed","name":"Login","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","name":"Content-Type","type":"text"}],"body":{"mode":"raw","raw":"{\n \"email\": \"correo@ejemplo.com\",\n \"password\": \"M1P@sswordSeguro\"\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/{{VERSION}}/login/"},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\n \"refresh\": \"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbl90eXBlIjoicmVmcmVzaCIsImV4cCI6MTYyODk3NDgyMiwianRpIjoiYWIyOTUwMDYwZTYxNDhmNzlhNzk3Zjc2ZWI3Njc0MTEiLCJ1c2VyX2lkIjoyOX0.9EJN4OYhcOKLuN_KI9vXALOqdX7mdLaQg1Nmi9fDG7w\",\n \"access\": \"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNjI4ODg4NzIyLCJqdGkiOiIwOWNmNzU3ZjhjZjc0NzQ5OTM4MDhhZGJiMzdlZTdkYiIsInVzZXJfaWQiOjI5fQ.1GdTk_XuWD7jSrFn2qU29tVUwlVpKwQ35F4jcO_KfnI\"\n}"}],"_postman_id":"ec8dcb94-1a43-43d8-ab21-c0aec3b6e2f9"},{"name":"Refresh","event":[{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","id":"7a5f1da3-94c3-4ef7-8edd-8d3840ffec9a"}}],"id":"775a4ea5-3949-46b6-a2c4-9dfdeb9d8df9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\"refresh\":\"{{REFRESH_TOKEN}}\"\n}"},"url":"{{HOST}}/api/{{VERSION}}/token/refresh/","description":"

El servicio de refresh se utiliza para actualizar el token de vida corta o de acceso. Para continuar renovando el acceso hacia los servicios web del API es necesario que este token se esté renovando cada cierto tiempo. Para poderlo hacer basta con únicamente estar enviando el token de refresh en un intervalo de tiempo determinado, así este nos regresará el token de acceso para poder seguir trabajando de manera normal.t

\n","urlObject":{"path":["api","{{VERSION}}","token","refresh",""],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"775a4ea5-3949-46b6-a2c4-9dfdeb9d8df9"}],"id":"29cb0d06-a2bd-4153-a9c6-f74f3bf68605","_postman_id":"29cb0d06-a2bd-4153-a9c6-f74f3bf68605","description":""},{"name":"Facturas","item":[{"name":"Acciones factura","item":[{"name":"Aprobar o rechazar facturas","id":"3a4be97f-2891-41f5-91df-4d07da10c23c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"invoice_id\": \"591217\",\n \"status\": \"approve\",\n \"payment_date\": \"21/11/2024\",\n \"rejection_note\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/api/{{VERSION}}/buyer/{{API_SECRET_KEY}}/approve/invoice/","description":"

Es el servicio para aprobar o rechazar facturas. Para aprobar una factura es necesario el id de la factura y el estado.

Las opciones válidas del estado de una factura son: \"approve\" y \"reject\". Si se ingresa otra opción, el servicio lo detecta y lanza un error.
Si el estado es \"approve\" y el campo de \"invoice_id\" es válido dentro del form-data, el servicio identifica que el \"payment_date\" no esté vacío y se confirma que sea una fecha válida. Al ser el estado \"approve\", la fecha es requerida.

Si el estado es \"reject\" y el campo de \"invoice_id\" es válido, el servicio ignora el campo \"payment_date\" y se rechaza la factura. En esta versión, se incluye el campo \"rejection_note\" (campo opcional), en el cual se puede indicar la razón de rechazo de la factura.

\n","urlObject":{"path":["api","{{VERSION}}","buyer","{{API_SECRET_KEY}}","approve","invoice",""],"host":["{{HOST}}"],"query":[{"disabled":true,"key":"","value":null}],"variable":[]}},"response":[],"_postman_id":"3a4be97f-2891-41f5-91df-4d07da10c23c"},{"name":"Obtener detalle de factura XML","id":"c7c50913-ff69-4e46-9c87-fa6d86adbf08","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{ACCESS_TOKEN}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"invoice_id","value":"862","type":"text"}]},"url":"{{HOST}}/api/{{VERSION}}/buyer/{{API_SECRET_KEY}}/xml-data-detail/","description":"

Es el servicio para mostrar el detalle completo de una factura electrónica cargada de forma automática al enviar por correo (fel@inboxgt.fibbo.app) el archivo XML y PDF. La información de la factura se muestra utilizando el id de la factura cargada en la plataforma.

Para iniciar hay que asegurarse que el servicio \"Renovar token\" siga siendo vigente y haya agregado el token generado (validar que no ha expirado). Se identifica en la pestaña de \"Authorization\" o en la pestaña de \"Headers\", siguiendo las instrucciones de autenticación que se describe en el servicio de \"Facturas\".

Luego hay que ingresar a la pestaña de Body y seleccionamos form-data. Se agrega los campos que el servicio indica: invoice_id

\n","urlObject":{"path":["api","{{VERSION}}","buyer","{{API_SECRET_KEY}}","xml-data-detail",""],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"c7c50913-ff69-4e46-9c87-fa6d86adbf08"},{"name":"Creacion de impuestos","id":"af89be6a-bd51-40c6-9bc1-72397145b697","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{ACCESS_TOKEN}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"invoice_id\": \"574\",\n \"amount\": \"9.99\",\n \"tax_name\": \"TIMBRE DE PRENSA\",\n \"currency_code\": \"GTQ\"\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/api/{{VERSION}}/buyer/{{API_SECRET_KEY}}/invoice/tax/","description":"

Es el servicio para agregar un impuesto adicional al detalle de las facturas, los cuales no son el IVA e ISR.

Los impuestos se representan con el campo \"tax_name\" y son permitidos para las facturas digitales (FEL) por la SAT. Los impuestos adicionales son y se escriben en el código de la siguiente forma: TIMBRE DE PRENSA, PETROLEO, TURISMO HOSPEDAJE, TURISMO PASAJES, BOMBEROS, TASA MUNICIPAL.

\n","urlObject":{"path":["api","{{VERSION}}","buyer","{{API_SECRET_KEY}}","invoice","tax",""],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"af89be6a-bd51-40c6-9bc1-72397145b697"}],"id":"b2857d84-d2ba-4bc7-a33d-e7d1d998f808","_postman_id":"b2857d84-d2ba-4bc7-a33d-e7d1d998f808","description":""},{"name":"Pagos","item":[{"name":"Pagar factura","id":"d4497c78-47ca-467b-ac6d-409ca1294b6e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{ACCESS_TOKEN}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"invoice_id\": \"591217\",\r\n \"account_id\": \"\",\r\n \"amount\": \"10\",\r\n \"transaction_number\": \"1500203901\",\r\n \"payment_date\": \"09/06/2022\",\r\n \"description\": \"PAGOS DE FACTURAS\",\r\n \"iva_retention\": \"0\",\r\n \"isr_retention\": \"0\",\r\n \"payment_method\": \"0\",\r\n \"invoice_payed\": false,\r\n \"account\": {\r\n \"number\": \"0000146969\",\r\n \"entity_code\": \"INDL\",\r\n \"country_code\": \"GT\",\r\n \"producttype_code\": \"01\",\r\n \"currency_code\": \"GTQ\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/api/{{VERSION}}/buyer/{{API_SECRET_KEY}}/invoice/payments/","description":"

Es el servicio para marcar como pagadas las facturas registrando un la información de pago.

Luego hay que ingresar a la pestaña de Body y seleccionamos form-data. Se agrega los campos que el servicio indica: invoice_id, account_id, amount, transaction_number, payment_date, description. Los campos obligatorios son los que tienen asteriscos.

Si los otros campos van vacíos o no se agregaron o están escritos incorrectamente, el servicio regresa una respuesta indicando que hacen falta campos obligatorios o que están mal escritos. Por lo que, el siguiente paso es revisar qué campo falta o identificar qué campo está escrito incorrectamente.

El campo \"payment_method\" indica el método que se utilizó para realizar el pago. Recibe un valor entero siendo las siguientes opciones: 0 = Depósito, 1 = Transferencia, 2 = Cheque, 3 = Tarjeta de débito, 4 = Tarjeta de crédito, 5 = Otros, 6 = Nota de crédito , 7 = Nota de abono. Los campos de \"account_id\" y \"transaction_number\" únicamente son obligatorios cuando el método de pago es por “Transferencia” o “Depósito”.

Si la respuesta en el campo \"invoice_payed\" se envía True, se ignoran las validaciones de pago de las facturas. Si no se incluye una respuesta en el \"request\" o se coloca False, se realizan las validaciones de pago de las facturas.

Es el servicio para borrar el registro de algún pago realizado de una factura.

\n","urlObject":{"path":["api","{{VERSION}}","buyer","{{API_SECRET_KEY}}","invoice","payments",""],"host":["{{HOST}}"],"query":[{"disabled":true,"key":"","value":null}],"variable":[]}},"response":[],"_postman_id":"4a085594-1ec1-442f-a02e-2d7b6aff909c"}],"id":"3bd3b041-537b-4bcb-9822-9511e6f46851","_postman_id":"3bd3b041-537b-4bcb-9822-9511e6f46851","description":""},{"name":"Listar facturas","id":"eb3bdf78-52d8-46db-82ac-4609b5fa71b7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{ACCESS_TOKEN}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":""},"url":"{{HOST}}/api/{{VERSION}}/buyer/{{API_SECRET_KEY}}/invoices/all/all/seller/{{SELLER_ID}}/pagination/{{PER_PAGE}}/{{PAGE}}/{{SEARCH}}/","description":"

Este servicio es para listar facturas asociadas a una empresa. Los parámetros son: category, invoice_status, seller_id, perPage, page, search, los cuales son obligatorios dentro de la url.

Al momento de solicitar el servicio, el campo \"search\" tiene que llevar un parámetro por defecto y se recomienda que sean los “” que representan un espacio en blanco. Se agrega un url de ejemplo de como debe de estar el Path compuesto.

Para poder acceder a este servicio y que esté funcionando basta únicamente con utilizar o seguir el path como ejemplo o guía para poder llenar el enlace y éste sea procesado correctamente por la plataforma. Además en \"Postman\" tenemos que ubicarnos en la pestaña de \"Authorization\" y seleccionar la opción de \"Bearer Token\". Luego hay que ingresar en el recuadro del lado derecho que tiene el mensaje de Token, e ingresar allí el token que nos genera el servicio de renovar token.

Ejemplo de cómo el enlace debería de ir compuesto: https://demo.fibbo.app/api/1.0/buyer/301b0f181248c31f30a027ccb03251ac9af5e9d221a7938a7c94332d7f208c1a/invoices/all/valid/seller/1/pagination/1/1/''/

\n","urlObject":{"path":["api","{{VERSION}}","buyer","{{API_SECRET_KEY}}","invoices","all","all","seller","{{SELLER_ID}}","pagination","{{PER_PAGE}}","{{PAGE}}","{{SEARCH}}",""],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"eb3bdf78-52d8-46db-82ac-4609b5fa71b7"},{"name":"Obtener los PDF","id":"84b229d1-fd1a-4a2c-a163-b9bce0445906","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{HOST}}/api/1.0/buyer/{{API_SECRET_KEY}}/invoice/pdfs/?invoice_id=851","description":"

Es el servicio para obtener varios archivos (XML y PDF) de facturas desde Fibbo y mandarlo al ERP.
El método usado es base 64. Los campos para este servicio son:** invoice_ids** (en este campo agregamos los ids de todas las facturas a las cuales necesitemos adjuntarle archivos mediante el id de la factura.

Notas

Asegúrese de que el ID de factura corresponda a una factura asociada a su cuenta de comprador.
\n
El PDF se generará a pedido o se recuperará de la caché según la configuración del sistema.
\n
Las facturas grandes pueden tardar más tiempo en generarse.
\n

\n","urlObject":{"path":["api","1.0","buyer","{{API_SECRET_KEY}}","invoice","pdfs",""],"host":["{{HOST}}"],"query":[{"disabled":true,"key":"page","value":"1"},{"disabled":true,"key":"per_page","value":"10"},{"disabled":true,"key":"seller_id","value":"8"},{"key":"invoice_id","value":"851"}],"variable":[]}},"response":[],"_postman_id":"84b229d1-fd1a-4a2c-a163-b9bce0445906"},{"name":"Creacion de factura","id":"54c6b6b4-ecbb-4654-b7f3-6b08f9e31109","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{ACCESS_TOKEN}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"serie","value":"file","type":"text"},{"key":"numero","value":"4","type":"text"},{"key":"nit","value":"p-1","type":"text"},{"key":"monto","value":"5497.3","type":"text"},{"key":"moneda","value":"GTQ","type":"text"},{"key":"iva","value":"2606.36","type":"text"},{"key":"retencion_isr","value":"0","type":"text"},{"key":"fecha_emitida","value":"10/02/2022","type":"text"},{"key":"fecha_pago","value":"22/02/2022","type":"text"},{"key":"retencion_iva","value":"390.95","type":"text"},{"key":"anticipo","value":"0","type":"text"},{"key":"nota","value":"Plaza Financiera Magdalena","type":"text"},{"key":"contrasena","value":"65","type":"text"},{"key":"fecha_contrasena","value":"14/02/2022","type":"text"},{"key":"numero_transaccion","value":"123","type":"text","disabled":true},{"key":"fecha_factura_pagada","value":"21/10/2021","type":"text","disabled":true},{"key":"orden_compra","value":"AAAa","type":"text","disabled":true},{"key":"orden_compra_fecha","value":"21/10/2021","type":"text","disabled":true},{"key":"orden_compra_departamento","value":"ITt","type":"text","disabled":true},{"key":"attachment","type":"file","src":"/C:/Users/ce/Downloads/Terce parcial.pdf"},{"key":"attachment","type":"file","src":"/C:/Users/ce/Downloads/Unidad 5.pdf"}]},"url":"{{HOST}}/api/{{VERSION}}/buyer/{{API_SECRET_KEY}}/invoice/","description":"

Es el servicio de crear facturas de proveedores que está asociados a un comprador. Los campos se refieren a los datos de las facturas y los campos obligatorios son los que tienen un asterístico.

En esta versión se incluye en los parámetros del servicio el campo \"nota\" que permite agregar una descripción a las facturas cuando son cargadas. También, el campo \"iva\" es un campo abierto y no es autocalculable. Si el campo no tiene un valor o está en blanco, el servicio asumirá que se trata de un cero.

Los campos relacionados a las órdenes de compra son opcionales. Si se creará una orden de compra se deben de enviar los 3 campos relacionados (orden_compra, orden_compra_fecha, orden_compra_departamento).

\n","urlObject":{"path":["api","{{VERSION}}","buyer","{{API_SECRET_KEY}}","invoice",""],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"54c6b6b4-ecbb-4654-b7f3-6b08f9e31109"},{"name":"Adjuntos","id":"5948db3b-4fcd-4e10-b703-36d93410872d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{ACCESS_TOKEN}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"invoice_ids","value":"740,1063","type":"text","disabled":true},{"key":"invoice_id","value":"1063","type":"default","disabled":true},{"key":"invoice_id","value":"63","type":"default"},{"key":"attachment","type":"file","src":"/C:/Users/ce/Downloads/84USNcDsU7J52wprmRNS (1).png"},{"key":"attachment_name","value":"adjunto desde api","type":"default"},{"key":"attachment_name","value":"no","type":"default","disabled":true},{"key":"attachment_name","value":"bruh","type":"default","disabled":true}]},"url":"{{HOST}}/api/{{VERSION}}/buyer/{{API_SECRET_KEY}}/invoice/attachment/","description":"

Es el servicio para adjuntar varios archivos a diferentes facturas en una sola solicitud mediante el id de la factura. Con el campo ** invoice_id** (como campo arreglo o individual) en form-data. También, es posible indicar el nombre de los adjuntos en el campo de attachment_name (como campo arreglo o individual).

Los campos para este servicio son:** invoice_ids** (en este campo agregamos los ids de todas las facturas a las cuales necesitemos adjuntarle archivos mediante el id de la factura. Es necesario y obligatorio que los ids estén separados por una coma o de lo contrario el servicio no funcionara de manera correcta) y attachment (es un campo obligatorio y se repite el mismo proceso para el servicio de \"Cargar factura\" en la sección de carga de archivos.

Si los otros campos van vacíos o no se agregaron o están escritos incorrectamente, el servicio regresa con una respuesta indicando que hacen falta campos obligatorios o que están mal escritos. Por lo que, el siguiente paso es revisar qué campo falta o identificar qué campo está escrito incorrectamente.

\n","urlObject":{"path":["api","{{VERSION}}","buyer","{{API_SECRET_KEY}}","invoice","attachment",""],"host":["{{HOST}}"],"query":[{"disabled":true,"key":"","value":null}],"variable":[]}},"response":[],"_postman_id":"5948db3b-4fcd-4e10-b703-36d93410872d"},{"name":"Actualizar factura","id":"3b98412f-1128-4427-ac6a-26bb430c9fd3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{ACCESS_TOKEN}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"invoice_id","value":"2501","type":"text"},{"key":"pass_code","value":"12345","type":"text","disabled":true},{"key":"pass_code_date","value":"21/08/2022","type":"text","disabled":true},{"key":"attachment","type":"file","src":"/C:/Users/ce/Downloads/[MyS1]HT3_200819117.spfx","disabled":true},{"key":"iva_retention","value":"100","type":"text"},{"key":"isr_retention","value":"500","type":"text","disabled":true},{"key":"advanced_payment","value":"50","type":"text"}]},"url":"{{HOST}}/api/{{VERSION}}/buyer/{{API_SECRET_KEY}}/update/invoice/","description":"

Es el servicio para actualizar la información de las facturas. Los campos que se pueden actualizar son el número de contraseña (pass_code), la fecha de contraseña (pass_code_date), fecha de pago, retención de ISR, retención de IVA y adjuntos de múltiples archivos. Para el proceso de actualización, es posible adjuntar varios archivos.

Luego hay que ingresar a la pestaña de Body y seleccionamos form-data. Se agrega los campos que el servicio indica: invoice_id, pass_code, pass_code_data y attachment. Éste último campo es opcional puede ir en la solicitud del servicio o no, el cual es el mismo proceso que se realiza en el servicio \"Cargar factura\" al querer subir archivos.

o indica los cuales son invoice_id, pass_code, pass_code_data y attachment este último campo es opcional puede ir en la solicitud del servicio o no repetimos el mismo proceso que realizamos en el servicio Cargar Factura para el proceso de carga de archivos, si los otros campos van vacíos ,no se agregaron o están escritos incorrectamente el servicio nos regresara una respuesta indicándonos que que hacen falta campos obligatorios o están mal escritos y que deberíamos de revisar qué campo es el faltante o cual no está escrito de la manera que debería de ir.

\n","urlObject":{"path":["api","{{VERSION}}","buyer","{{API_SECRET_KEY}}","update","invoice",""],"host":["{{HOST}}"],"query":[{"disabled":true,"key":"","value":null}],"variable":[]}},"response":[],"_postman_id":"3b98412f-1128-4427-ac6a-26bb430c9fd3"},{"name":"Eliminar factura","id":"fe8a58ad-6ba2-4ea7-a906-0d4e48a3d4cc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{HOST}}/api/{{VERSION}}/buyer/{{API_SECRET_KEY}}/invoice/{{INVOICE_ID}}/","description":"

Es el servicio para poder eliminar facturas en la plataforma utilizando el respectivo ID.

\n","urlObject":{"path":["api","{{VERSION}}","buyer","{{API_SECRET_KEY}}","invoice","{{INVOICE_ID}}",""],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"fe8a58ad-6ba2-4ea7-a906-0d4e48a3d4cc"}],"id":"365fa712-7f5a-4bc7-83ae-e6678ae7186a","_postman_id":"365fa712-7f5a-4bc7-83ae-e6678ae7186a","description":""},{"name":"Proveedores","item":[{"name":"Invitar proveedor","id":"6d33385c-ca19-4e1f-ba0b-da019b5ac5e9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"p13@fibbo.app\",\n \"nit\": \"p13\",\n \"name\": \"proveedor 13\",\n \"code\": \"codigo 3\"\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/api/{{VERSION}}/buyer/{{API_SECRET_KEY}}/sellers/invite/","description":"

Es el servicio para invitar a un proveedor por medio de la plataforma para que pertenezca a la red del comprador.

Si el proveedor ya tiene una cuenta en la plataforma, el proveedor se agrega de forma inmediata. Si el proveedor aún no tiene cuenta en la plataforma, entonces recibe una invitación a su correo electrónico para crear cuenta.

Los campos obligatorios son: email, nit, name. El campo \"code\" (código de proveedor) es opcional.

\n","urlObject":{"path":["api","{{VERSION}}","buyer","{{API_SECRET_KEY}}","sellers","invite",""],"host":["{{HOST}}"],"query":[{"disabled":true,"key":"","value":null}],"variable":[]}},"response":[],"_postman_id":"6d33385c-ca19-4e1f-ba0b-da019b5ac5e9"},{"name":"Detalle proveedor","id":"b6aaceca-99bc-469d-afa4-30d4eba01922","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{ACCESS_TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/api/{{VERSION}}/buyer/{{API_SECRET_KEY}}/sellers/detail/{{SELLER_ID}}/","description":"

Es el servicio para obtener más detalle de un proveedor específico.

\n","urlObject":{"path":["api","{{VERSION}}","buyer","{{API_SECRET_KEY}}","sellers","detail","{{SELLER_ID}}",""],"host":["{{HOST}}"],"query":[{"disabled":true,"key":"","value":null}],"variable":[]}},"response":[],"_postman_id":"b6aaceca-99bc-469d-afa4-30d4eba01922"},{"name":"Listar cuentas asignadas","id":"bd3b1cc2-4fdb-4d60-928a-bf3f99cd99fa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{ACCESS_TOKEN}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":""},"url":"{{HOST}}/api/{{VERSION}}/buyer/{{API_SECRET_KEY}}/account-assigned/company/","description":"

Es el servicio para listar todas las cuentas bancarias asignadas por todos los proveedores para pago de facturas.

\n","urlObject":{"path":["api","{{VERSION}}","buyer","{{API_SECRET_KEY}}","account-assigned","company",""],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"bd3b1cc2-4fdb-4d60-928a-bf3f99cd99fa"},{"name":"Listar proveedores","id":"54050401-6afb-477e-b60b-7e0adc516f8f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{ACCESS_TOKEN}}"}]},"isInherited":false},"method":"GET","header":[],"url":"{{HOST}}/api/{{VERSION}}/buyer/{{API_SECRET_KEY}}/sellers/","description":"

Es el servicio para listar a todos los proveedores que están en la red del comprador (\"Mi red\").

\n","urlObject":{"path":["api","{{VERSION}}","buyer","{{API_SECRET_KEY}}","sellers",""],"host":["{{HOST}}"],"query":[{"disabled":true,"key":"nit","value":"p"},{"disabled":true,"key":"seller_code","value":"2"}],"variable":[]}},"response":[],"_postman_id":"54050401-6afb-477e-b60b-7e0adc516f8f"},{"name":"Cuenta de banco por proveedor","id":"6481a3e5-6fdb-4321-8a23-4273a87e3195","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{ACCESS_TOKEN}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":""},"url":"{{HOST}}/api/{{VERSION}}/buyer/{{API_SECRET_KEY}}/account-assigned/company/{{SELLER_ID}}/","description":"

Es el servicio para listar las cuentas bancarias asignadas por un proveedor en específico.

\n","urlObject":{"path":["api","{{VERSION}}","buyer","{{API_SECRET_KEY}}","account-assigned","company","{{SELLER_ID}}",""],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"6481a3e5-6fdb-4321-8a23-4273a87e3195"},{"name":"Actualizar proveedor","id":"e5d16489-c7db-4bf7-9f01-3c188bc6c021","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{ACCESS_TOKEN}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"code\": \"NUEVO CODIGO\",\n \"fixed_rate_code\": \"AA3\"\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/api/{{VERSION}}/buyer/{{API_SECRET_KEY}}/sellers/update/{{SELLER_ID}}/","description":"

Es el servicio para actualizar la información de un proveedor específico. El campo disponible es el código del proveedor.

\n","urlObject":{"path":["api","{{VERSION}}","buyer","{{API_SECRET_KEY}}","sellers","update","{{SELLER_ID}}",""],"host":["{{HOST}}"],"query":[{"disabled":true,"key":"","value":null}],"variable":[]}},"response":[],"_postman_id":"e5d16489-c7db-4bf7-9f01-3c188bc6c021"}],"id":"2648b5f4-b64f-4c5b-9553-01a3881e6baf","_postman_id":"2648b5f4-b64f-4c5b-9553-01a3881e6baf","description":""},{"name":"Ordenes de compra","item":[{"name":"list","id":"2a92ea0c-5331-4ae1-8157-87f252bd1506","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{HOST}}/api/1.0/buyer/{{API_SECRET_KEY}}/purchase_order/?invoice_id=851","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{ACCESS_TOKEN}}"}]},"isInherited":true,"source":{"_postman_id":"3f7aa1e7-8c82-45f0-968f-5c37e7d643d7","id":"3f7aa1e7-8c82-45f0-968f-5c37e7d643d7","name":"Ordenes de compra","type":"folder"}},"urlObject":{"path":["api","1.0","buyer","{{API_SECRET_KEY}}","purchase_order",""],"host":["{{HOST}}"],"query":[{"disabled":true,"key":"page","value":"1"},{"disabled":true,"key":"per_page","value":"10"},{"disabled":true,"key":"seller_id","value":"8"},{"key":"invoice_id","value":"851"}],"variable":[]}},"response":[],"_postman_id":"2a92ea0c-5331-4ae1-8157-87f252bd1506"},{"name":"create","id":"427ffaff-1843-4083-99dd-d0f16e4a8a1e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"invoice_id\": \"22\",\n \"order_id\": \"alt112\",\n \"placed_date\": \"12/10/25\",\n \"department\": \"IT\",\n \"seller_id\": \"106\",\n \"detail\": [\n {\n \"quantity\": \"1\",\n \"description\": \"Detalle ejemplo\",\n \"unit_price\": \"11.00\",\n \"total\": \"11.00\"\n },\n {\n \"quantity\": \"2\",\n \"description\": \"Detalle ejemplo\",\n \"unit_price\": \"22.00\",\n \"total\": \"44.00\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/api/1.0/buyer/{{API_SECRET_KEY}}/purchase_order/","description":"

Es el servicio para crear una orden de compra para facturas. Se puede crear una orden de compra para facturas existentes y no existentes en la plataforma.

Los campos relacionados a las órdenes de compras son: order_id, placed_date, departement.

El campo de detail (opcional) se puede utilizar para agregar múltiples de líneas del detalle de la orden de compra o bien es posible utilizar el servicio de agregar línea por línea según sea la necesidad de cada escenario.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{ACCESS_TOKEN}}"}]},"isInherited":true,"source":{"_postman_id":"3f7aa1e7-8c82-45f0-968f-5c37e7d643d7","id":"3f7aa1e7-8c82-45f0-968f-5c37e7d643d7","name":"Ordenes de compra","type":"folder"}},"urlObject":{"path":["api","1.0","buyer","{{API_SECRET_KEY}}","purchase_order",""],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"427ffaff-1843-4083-99dd-d0f16e4a8a1e"},{"name":"update","id":"5df36541-201b-408b-948a-450ca9cf4106","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"formdata","formdata":[{"key":"order_registration_id","value":"209","type":"text"},{"key":"seller_id","value":"152","type":"text"},{"key":"order_id","value":"nuevo id","type":"text"},{"key":"placed_date","value":"12/3/2500","type":"text","disabled":true},{"key":"department","value":"bruh","type":"text","disabled":true}]},"url":"{{HOST}}/api/1.0/buyer/{{API_SECRET_KEY}}/purchase_order/","description":"

Es el servicio para actualizar una orden de compra existente. Las facturas relacionadas deben de tener un estado vigente y no haber sido pagadas.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{ACCESS_TOKEN}}"}]},"isInherited":true,"source":{"_postman_id":"3f7aa1e7-8c82-45f0-968f-5c37e7d643d7","id":"3f7aa1e7-8c82-45f0-968f-5c37e7d643d7","name":"Ordenes de compra","type":"folder"}},"urlObject":{"path":["api","1.0","buyer","{{API_SECRET_KEY}}","purchase_order",""],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"5df36541-201b-408b-948a-450ca9cf4106"},{"name":"delete","id":"05c5644a-799f-412f-885e-fe6e71364cb2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\r\n \"order_registration_id\": \"203\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/api/1.0/buyer/{{API_SECRET_KEY}}/purchase_order/","description":"

Es el servicio para eliminar una orden de compra existente.

Es el servicio para obtener el listado de las órdenes de compra de las facturas con estado vigente.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{ACCESS_TOKEN}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"5efa2872-d173-413e-8e56-f5bb8ac69375","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"6c267d7d-18eb-4b1d-842f-aa9a50cd78c5","type":"text/javascript","exec":[""]}}],"_postman_id":"3f7aa1e7-8c82-45f0-968f-5c37e7d643d7"},{"name":"Detalle de orden de compra","item":[{"name":"list","id":"4931b48d-f5a4-43fc-a1b9-0ac4ceed3355","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{HOST}}/api/1.0/buyer/{{API_SECRET_KEY}}/purchase_order_detail/?purchase_order_id=194","description":"

Es el servicio para obtener el listado del detalle de las órdenes de compra de las facturas con estado vigente.

Es el servicio para agregar nuevas líneas al detalle de una orden de compra. La factura relacionada debe tener estado vigente.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{ACCESS_TOKEN}}"}]},"isInherited":true,"source":{"_postman_id":"2d703db3-2ab2-4e4f-9657-f6af73fcf120","id":"2d703db3-2ab2-4e4f-9657-f6af73fcf120","name":"Detalle de orden de compra","type":"folder"}},"urlObject":{"path":["api","1.0","buyer","{{API_SECRET_KEY}}","purchase_order_detail",""],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"26a6f41e-a296-4435-b128-6c7e0ef3ccd3"}],"id":"2d703db3-2ab2-4e4f-9657-f6af73fcf120","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{ACCESS_TOKEN}}"}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"bd69cb16-0b74-4780-92a5-1b2145a6b7e1","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"3226edd1-2c0b-4c5a-953e-1d812b25229d","type":"text/javascript","exec":[""]}}],"_postman_id":"2d703db3-2ab2-4e4f-9657-f6af73fcf120","description":""},{"name":"Pronto pagos","item":[{"name":"Pagar pronto Pagos","id":"477403d6-f507-4186-bf34-cd6a7cbebea0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"early_payment_id\": \"9\",\n \"account_id\": \"54\",\n \"amount\": \"490000\",\n \"transaction_number\": \"123\",\n \"payment_method\": 6,\n \"payment_date\": \"23/07/2024\",\n \"description\": \"pago\"\n} ","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/api/{{VERSION}}/buyer/{{API_SECRET_KEY}}/early_payments/payed/","urlObject":{"path":["api","{{VERSION}}","buyer","{{API_SECRET_KEY}}","early_payments","payed",""],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"477403d6-f507-4186-bf34-cd6a7cbebea0"},{"name":"Listar pronto pagos","id":"022f4fa0-87b4-41ec-b1b9-6d417f1913e0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"early_payment_id\": \"3\",\n \"account_id\": \"54\",\n \"amount\": \"29400\",\n \"transaction_number\": \"123\",\n \"payment_method\": 6,\n \"payment_date\": \"23/07/2024\",\n \"description\": \"pago\"\n} ","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/api/{{VERSION}}/buyer/{{API_SECRET_KEY}}/early_payments/","description":"

Es el servicio para obtener el listado de los prontos pagos de diferentes facturas.

Los estados de los prontos pagos son:

0 = Pendiente (comprador envió una solicitud de pronto pago y el proveedor debe revisar)
\n
1 = Aprobado (pronto pago ya fue aprobado con las respectivas condiciones)
\n
2 = Desembolsado (pronto pago ya fue desembolsado)
\n
(-1) = Rechazado (solicitud del pronto pago fue rechazdo)
\n
(-2) = Pendiente (proveedor envió una solicitud del pronto pago y el comprador debe revisar)
\n
(-3) = Anulado (comprador anula la solicitud del pronto pago)
\n

\n","urlObject":{"path":["api","{{VERSION}}","buyer","{{API_SECRET_KEY}}","early_payments",""],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"022f4fa0-87b4-41ec-b1b9-6d417f1913e0"}],"id":"d83a087b-6db2-4400-8fa0-8d547601237d","_postman_id":"d83a087b-6db2-4400-8fa0-8d547601237d","description":""}]}