{"info":{"_postman_id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","name":"YaloCobro External API - Completa","description":"

Documentacion completa de la API externa de YaloCobro (YALO-API-ExternalService).

AUTENTICACION:

La mayoria de endpoints usan API Key: header 'api-key' con el valor de la variable REEMPLAZAR_CON_TU_API_KEY (configurado a nivel de coleccion, se hereda).
\n
Algunos endpoints usan JWT del cliente final ([Authorize]): envian Bearer REEMPLAZAR_CON_TU_JWT. El token se obtiene de SignIn.
\n
SignIn, RefreshToken (usan API Key) y Health (sin auth).
\n

VARIABLES:

base_url: host de la API (ej. https://apiservices2.yalocobro.com/)
\n
api_key: tu API Key de organizacion
\n
jwt_token: token JWT devuelto por SignIn (para endpoints del cliente final)
\n

NOTA: Las carpetas 'Table Map', 'Kitchen Monitor' y el endpoint 'Invoices > GetCustomerPurchases' corresponden a features en ramas aun no mergeadas (feature/table-map-kitchen-monitor-endpoints, feature/customer-purchase-history). Estaran disponibles cuando esas ramas lleguen a produccion.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"32044146","collectionId":"b5f52e5f-77d2-49de-b824-3e2838e53e24","publishedId":"2sBXwtppbW","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-06-16T22:48:28.000Z"},"item":[{"name":"SignIn","item":[{"name":"Autenticar","id":"a2f84df4-ac17-4608-b70c-17a839778d68","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"email\": \"usuario@example.com\",\n \"password\": \"P@ssw0rd123\"\n}"},"url":"https://api.yalocobro.com/api/v1/SignIn","description":"

Auth: API Key (heredada). Autentica un cliente por email/password y devuelve { token, refresh_token, result, error }. El token se usa como REEMPLAZAR_CON_TU_JWT para los endpoints [Authorize].

Auth: API Key (heredada). Intercambia un JWT expirado + refresh_token por un token nuevo. token_expired debe estar realmente vencido.

Auth: JWT (Bearer). Datos del cliente autenticado (nombre, email, telefono, genero, documentos y campos personalizados).

\n","urlObject":{"path":["api","v1","Customers"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"19dfc661-4a5f-47e9-8b48-dcac82a56221"},{"name":"Check Phone Number Exists (busqueda por telefono)","id":"a303de06-0b57-4b15-b428-0e0c4cbadfa5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.yalocobro.com/api/v1/Customers/CheckPhoneNumberExists?phone_number=50499998888","description":"

Auth: API Key (heredada). Busca un cliente por telefono (busqueda tolerante por los ultimos 8 digitos: funciona con o sin codigo de pais 504). Devuelve { id_customer, name, email, phone_number } o 404.

Auth: API Key (heredada). Crea un cliente y su autenticacion. Si ya existe un cliente con ese telefono, solo se le asocia el nuevo auth. id_type_field e id_custom_field deben existir y ser distintos de 0.

Auth: JWT (Bearer). Actualiza el perfil del cliente autenticado.

\n","urlObject":{"path":["api","v1","Customers"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"e05325f7-ee01-4110-9bc4-37850f62d4d6"}],"id":"fddbc1f6-dc04-494b-a881-abf0353485fe","_postman_id":"fddbc1f6-dc04-494b-a881-abf0353485fe","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"REEMPLAZAR_CON_TU_API_KEY"}]},"isInherited":true,"source":{"_postman_id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","name":"YaloCobro External API - Completa","type":"collection"}}},{"name":"Customers Addresses","item":[{"name":"Get Addresses","id":"b3d08a14-c89f-4212-9f86-85a983a7dffa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"REEMPLAZAR_CON_TU_JWT"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.yalocobro.com/api/v1/Customers/Addresses","description":"

Auth: JWT (Bearer). Lista las direcciones del cliente autenticado.

\n","urlObject":{"path":["api","v1","Customers","Addresses"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"b3d08a14-c89f-4212-9f86-85a983a7dffa"},{"name":"Post Address (crear)","id":"be8fba6e-cb97-4d4b-9076-bad6c0de7461","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"REEMPLAZAR_CON_TU_JWT"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"address\": \"Colonia Kennedy, bloque 5, casa 12\",\n \"address_2\": \"Apartamento 3B\",\n \"street\": \"Avenida Los Proceres\",\n \"city\": \"Tegucigalpa\",\n \"department\": \"Francisco Morazan\",\n \"reference_point\": \"Frente al parque central\",\n \"latitude\": \"14.072275\",\n \"longitude\": \"-87.192136\",\n \"is_default\": true\n}"},"url":"https://api.yalocobro.com/api/v1/Customers/Addresses","description":"

Auth: JWT (Bearer). Crea una direccion. Si is_default=true, desmarca las demas.

\n","urlObject":{"path":["api","v1","Customers","Addresses"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"be8fba6e-cb97-4d4b-9076-bad6c0de7461"},{"name":"Put Address (actualizar)","id":"83b63842-6b81-472c-b9db-a35cbe70103f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"REEMPLAZAR_CON_TU_JWT"}]},"isInherited":false},"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"address\": \"Colonia Kennedy, bloque 5, casa 12\",\n \"address_2\": \"Apartamento 3B\",\n \"street\": \"Avenida Los Proceres\",\n \"city\": \"Tegucigalpa\",\n \"department\": \"Francisco Morazan\",\n \"reference_point\": \"Frente al parque central\",\n \"latitude\": \"14.072275\",\n \"longitude\": \"-87.192136\",\n \"is_default\": true\n}"},"url":"https://api.yalocobro.com/api/v1/Customers/Addresses/123","description":"

Auth: JWT (Bearer). Actualiza la direccion {id} del cliente autenticado.

\n","urlObject":{"path":["api","v1","Customers","Addresses","123"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"83b63842-6b81-472c-b9db-a35cbe70103f"},{"name":"Delete Address","id":"2f248ab5-dc94-4696-966e-947cb21f6541","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"REEMPLAZAR_CON_TU_JWT"}]},"isInherited":false},"method":"DELETE","header":[],"url":"https://api.yalocobro.com/api/v1/Customers/Addresses/123","description":"

Auth: JWT (Bearer). Elimina (logico) la direccion {id}.

\n","urlObject":{"path":["api","v1","Customers","Addresses","123"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"2f248ab5-dc94-4696-966e-947cb21f6541"}],"id":"55f276bb-1bd8-4bed-9c40-91170159ea39","_postman_id":"55f276bb-1bd8-4bed-9c40-91170159ea39","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"REEMPLAZAR_CON_TU_API_KEY"}]},"isInherited":true,"source":{"_postman_id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","name":"YaloCobro External API - Completa","type":"collection"}}},{"name":"Customers Password","item":[{"name":"Change Password","id":"a6081bef-5059-4d3d-938a-d6cb0adeb242","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"REEMPLAZAR_CON_TU_JWT"}]},"isInherited":false},"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"current_password\": \"\",\n \"new_password\": \"\"\n}"},"url":"https://api.yalocobro.com/api/v1/CustomersPassword/change","description":"

Auth: JWT (Bearer). Cambia la contrasena del cliente autenticado. current_password y new_password se envian encriptados con RSA. 401 si la actual no coincide.

\n","urlObject":{"path":["api","v1","CustomersPassword","change"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"a6081bef-5059-4d3d-938a-d6cb0adeb242"}],"id":"9504d25c-786d-48e1-b6b2-bc2c2b872bb9","_postman_id":"9504d25c-786d-48e1-b6b2-bc2c2b872bb9","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"REEMPLAZAR_CON_TU_API_KEY"}]},"isInherited":true,"source":{"_postman_id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","name":"YaloCobro External API - Completa","type":"collection"}}},{"name":"Custom Fields","item":[{"name":"Get Custom Fields","id":"de99e6f9-b201-49b6-9e08-658013dc9693","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.yalocobro.com/api/v1/CustomFields","description":"

Auth: API Key (heredada). Lista los campos personalizados activos de la organizacion.

Auth: API Key (heredada). Establecimientos de la organizacion (excluye bodegas y eliminados).

Auth: API Key (heredada). Establecimientos ordenados por cercania (marca el mas cercano con nearest=true).

Auth: API Key (heredada). Paises asociados a la organizacion.

Auth: API Key (heredada). Departamentos de un pais (path id = Codpais).

Auth: API Key (heredada). Ciudades de un departamento (path id = Coddepartamento).

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"REEMPLAZAR_CON_TU_API_KEY"}]},"isInherited":true,"source":{"_postman_id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","name":"YaloCobro External API - Completa","type":"collection"}},"urlObject":{"path":["api","v1","Locations","Cities","1"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"f18cd742-12e1-4e57-95cd-97066ec74f3c"}],"id":"61072d3b-ddaf-4a27-aa05-2033bf9b8ab8","_postman_id":"61072d3b-ddaf-4a27-aa05-2033bf9b8ab8","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"REEMPLAZAR_CON_TU_API_KEY"}]},"isInherited":true,"source":{"_postman_id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","name":"YaloCobro External API - Completa","type":"collection"}}},{"name":"Products","item":[{"name":"Search Products (POST)","id":"f041a6e6-efd3-4ec0-9330-a5e8f8fb1143","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"keyword\": \"camisa\",\n \"min_price\": 10.00,\n \"max_price\": 500.00,\n \"id_categories\": [1, 2],\n \"id_sub_categories\": [5],\n \"id_brands\": [3],\n \"id_product_types\": [1],\n \"id_discounts\": [7],\n \"only_promotions\": false,\n \"page\": 1,\n \"limit\": 20,\n \"sort\": { \"field\": \"price\", \"order\": \"asc\" }\n}"},"url":"https://api.yalocobro.com/api/v1/Products","description":"

Auth: API Key (heredada). Busca productos con filtros. id_product_types filtra por tipo (producto/servicio/compuesto). La respuesta de cada producto incluye id_product_type y product_type.

Auth: API Key (heredada). path id = Codproducto. Respuesta incluye id_product_type y product_type.

Auth: API Key (heredada). Productos mas vendidos.

Auth: JWT (Bearer). Productos recomendados para el cliente autenticado.

\n","urlObject":{"path":["api","v1","Products","Recommended"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"be42620a-1e73-49c8-9515-0b8289703aa8"},{"name":"Get Related Products","id":"02157b7f-f906-4dfa-96d3-ef4f4eb2928b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.yalocobro.com/api/v1/Products/Related/123","description":"

Auth: API Key (heredada). Hasta 5 productos de la misma categoria (path id = Codproducto).

Auth: API Key (heredada). Lista marcas activas.

Auth: API Key (heredada). Categorias con subcategorias.

Auth: API Key (heredada). path id = Codcategoriaproducto.

Auth: API Key (heredada). path = CodProducto. Si tiene variaciones devuelve lista; si no, un StockDTO.

Auth: API Key (heredada). path = CodVariacion.

Auth: API Key (heredada). Metodos de pago habilitados del establecimiento.

Auth: API Key (heredada). Valida un cupon contra un total y devuelve validez, porcentaje y nuevo total.

Auth: API Key (heredada). Descuentos activos de la organizacion.

Auth: API Key (heredada). Tipos de pedido habilitados del establecimiento.

Auth: JWT (Bearer). Tarjetas del cliente autenticado.

\n","urlObject":{"path":["api","v1","CustomerCard"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"c298bab6-46ff-4a88-89c8-713b04ae2919"},{"name":"Get Card By Id","id":"95e81fc1-b6bb-4cc4-8a97-445a31ec71bb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"REEMPLAZAR_CON_TU_JWT"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.yalocobro.com/api/v1/CustomerCard/1","description":"

Auth: JWT (Bearer). path id = identificador de tarjeta.

\n","urlObject":{"path":["api","v1","CustomerCard","1"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"95e81fc1-b6bb-4cc4-8a97-445a31ec71bb"},{"name":"Create Card","id":"5fb5ef01-d485-41b6-80db-b86fbb76f0b3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"REEMPLAZAR_CON_TU_JWT"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"Id\": 0,\n \"Alias\": \"My Visa\",\n \"Mask\": \"411111******1111\",\n \"OwnerName\": \"Juan Perez\",\n \"ExpirationYear\": \"2028\",\n \"ExpirationMonth\": \"12\",\n \"Token\": \"tok_abc123xyz456\",\n \"BrandName\": \"VISA\",\n \"CreatedDate\": \"2026-06-16T10:30:00\",\n \"IsActive\": true,\n \"IsDefault\": true\n}"},"url":"https://api.yalocobro.com/api/v1/CustomerCard","description":"

Auth: JWT (Bearer). CodCliente/CodOrganizacion se leen del token. IsActive se fuerza a true en el servidor.

\n","urlObject":{"path":["api","v1","CustomerCard"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"5fb5ef01-d485-41b6-80db-b86fbb76f0b3"},{"name":"Update Card","id":"8048c368-51e4-42a8-8900-16ba31085dca","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"REEMPLAZAR_CON_TU_JWT"}]},"isInherited":false},"method":"PUT","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"Id\": 1,\n \"Alias\": \"My Visa Updated\",\n \"Mask\": \"411111******1111\",\n \"OwnerName\": \"Juan Perez\",\n \"ExpirationYear\": \"2029\",\n \"ExpirationMonth\": \"06\",\n \"Token\": \"tok_abc123xyz456\",\n \"BrandName\": \"VISA\",\n \"CreatedDate\": \"2026-06-16T10:30:00\",\n \"IsActive\": true,\n \"IsDefault\": false\n}"},"url":"https://api.yalocobro.com/api/v1/CustomerCard","description":"

Auth: JWT (Bearer). La tarjeta a actualizar se identifica por 'Id' en el body. 404 si no existe.

\n","urlObject":{"path":["api","v1","CustomerCard"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"8048c368-51e4-42a8-8900-16ba31085dca"},{"name":"Approve Card Transaction","id":"c69724b9-565a-48f3-930a-13e8b7ca6878","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"REEMPLAZAR_CON_TU_JWT"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"TransactionIdentifier\": \"TXN-2026-0001\",\n \"TotalAmount\": 1500.50,\n \"CurrencyCode\": \"320\",\n \"ResponseMessage\": \"Approved\",\n \"Productos\": [\n { \"CodProducto\": 5001, \"NombreProducto\": \"Producto A\", \"Precio\": 750.25 }\n ],\n \"CardBrand\": \"VISA\",\n \"IsoResponseCode\": \"00\",\n \"AuthenticationStatus\": \"Y\",\n \"ProtocolVersion\": \"2.2.0\",\n \"Eci\": \"05\",\n \"ResponseCode\": \"00\",\n \"OrderIdentifier\": \"ORD-2026-0001\",\n \"SpiToken\": \"spi_token_abc123\",\n \"DsTransId\": \"ds-trans-7788\",\n \"TransactionStain\": \"stain-9900\",\n \"Cavv\": \"AAABBJg0VhI0VniQEjRWAAAAAAA=\",\n \"CodFactura\": 2002\n}"},"url":"https://api.yalocobro.com/api/v1/CustomerCard/CardTransactions","description":"

Auth: JWT (Bearer). CodCliente/CodOrganizacion del token. Persiste una transaccion de tarjeta y devuelve TransactionccId.

\n","urlObject":{"path":["api","v1","CustomerCard","CardTransactions"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"c69724b9-565a-48f3-930a-13e8b7ca6878"},{"name":"Get Card Transaction","id":"7bc1b10b-6547-442a-986b-007440ecd3a2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"REEMPLAZAR_CON_TU_JWT"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.yalocobro.com/api/v1/CustomerCard/CardTransactions/1","description":"

Auth: JWT (Bearer). path = TransactionccId. 404 si no hay transacciones.

\n","urlObject":{"path":["api","v1","CustomerCard","CardTransactions","1"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"7bc1b10b-6547-442a-986b-007440ecd3a2"}],"id":"4cb8c4c6-f715-4f27-ac83-e032afdddc36","_postman_id":"4cb8c4c6-f715-4f27-ac83-e032afdddc36","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"REEMPLAZAR_CON_TU_API_KEY"}]},"isInherited":true,"source":{"_postman_id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","name":"YaloCobro External API - Completa","type":"collection"}}},{"name":"Loyalty","item":[{"name":"Get Loyalty Points","id":"efce4f5b-352a-44d0-b501-f3a18fcdf207","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"REEMPLAZAR_CON_TU_JWT"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.yalocobro.com/api/v1/Loyalty","description":"

Auth: JWT (Bearer). Puntos de lealtad del cliente autenticado.

\n","urlObject":{"path":["api","v1","Loyalty"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"efce4f5b-352a-44d0-b501-f3a18fcdf207"},{"name":"Convert Points to Payment","id":"71e913eb-9f3e-42c8-96a9-0f88a808deed","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"REEMPLAZAR_CON_TU_JWT"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.yalocobro.com/api/v1/Loyalty/Payments?points=100","description":"

Auth: JWT (Bearer). Convierte puntos a dinero/metodo de pago. points > 0.

\n","urlObject":{"path":["api","v1","Loyalty","Payments"],"host":["https://api.yalocobro.com"],"query":[{"key":"points","value":"100"}],"variable":[]}},"response":[],"_postman_id":"71e913eb-9f3e-42c8-96a9-0f88a808deed"}],"id":"d1bce14f-1452-4279-9a08-88ba611d6d18","_postman_id":"d1bce14f-1452-4279-9a08-88ba611d6d18","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"REEMPLAZAR_CON_TU_API_KEY"}]},"isInherited":true,"source":{"_postman_id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","name":"YaloCobro External API - Completa","type":"collection"}}},{"name":"CustomerReward","item":[{"name":"Get Rewards","id":"c3cf0c06-ded0-47c8-a164-a6c82678b453","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"REEMPLAZAR_CON_TU_JWT"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.yalocobro.com/api/v1/Loyalty/Reward","description":"

Auth: JWT (Bearer). Premios (rewards) del cliente autenticado.

\n","urlObject":{"path":["api","v1","Loyalty","Reward"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"c3cf0c06-ded0-47c8-a164-a6c82678b453"},{"name":"Get Reward By Id","id":"21564450-b445-4e29-b5f4-827ac584907b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"REEMPLAZAR_CON_TU_JWT"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.yalocobro.com/api/v1/Loyalty/Reward/1","description":"

Auth: JWT (Bearer). path id = Codpremioxcliente.

\n","urlObject":{"path":["api","v1","Loyalty","Reward","1"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"21564450-b445-4e29-b5f4-827ac584907b"},{"name":"Create Reward","id":"09a8113d-e49d-4540-bbd9-5dcaf9273e1e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"REEMPLAZAR_CON_TU_JWT"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"customer_reward_code\": 0,\n \"customer_code\": 1024,\n \"product_code\": 5012,\n \"earned_date\": \"2026-06-16T10:30:00\",\n \"redeemed_date\": \"2026-06-20T15:00:00\",\n \"is_active\": true,\n \"is_deleted\": false,\n \"organization_code\": 42,\n \"source\": \"APP\"\n}"},"url":"https://api.yalocobro.com/api/v1/Loyalty/Reward","description":"

Auth: JWT (Bearer). Crea un premio. customer_code y organization_code no pueden ser 0 ni null.

\n","urlObject":{"path":["api","v1","Loyalty","Reward"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"09a8113d-e49d-4540-bbd9-5dcaf9273e1e"}],"id":"75ea4087-9460-4395-a6c8-b0846548323f","_postman_id":"75ea4087-9460-4395-a6c8-b0846548323f","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"REEMPLAZAR_CON_TU_API_KEY"}]},"isInherited":true,"source":{"_postman_id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","name":"YaloCobro External API - Completa","type":"collection"}}},{"name":"Invoices","item":[{"name":"Get Invoices (cliente autenticado)","id":"b40937b5-5cd2-45e8-a6b2-c718a7f68317","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"REEMPLAZAR_CON_TU_JWT"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.yalocobro.com/api/v1/Invoices","description":"

Auth: JWT (Bearer). Lista de facturas del cliente autenticado.

\n","urlObject":{"path":["api","v1","Invoices"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"b40937b5-5cd2-45e8-a6b2-c718a7f68317"},{"name":"Get Invoice By Id","id":"aa5a42fd-8add-4b6c-a2d1-d106408f8b0d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"REEMPLAZAR_CON_TU_JWT"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.yalocobro.com/api/v1/Invoices/1","description":"

Auth: JWT (Bearer). Detalle de una factura del cliente autenticado (productos, pagos, direccion, estados).

\n","urlObject":{"path":["api","v1","Invoices","1"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"aa5a42fd-8add-4b6c-a2d1-d106408f8b0d"},{"name":"Get Customer Purchases (historial por cliente) [rama feature]","id":"e83e0199-3474-42e0-af92-260d6dcf23ef","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.yalocobro.com/api/v1/Invoices/Customer/1?page=1&limit=20","description":"

Auth: API Key (heredada). [Pendiente de merge: rama feature/customer-purchase-history] Historial de compras de un cliente (path id = id_customer): facturas con producto, monto y fecha. Paginacion opcional.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"REEMPLAZAR_CON_TU_API_KEY"}]},"isInherited":true,"source":{"_postman_id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","name":"YaloCobro External API - Completa","type":"collection"}},"urlObject":{"path":["api","v1","Invoices","Customer","1"],"host":["https://api.yalocobro.com"],"query":[{"key":"page","value":"1"},{"key":"limit","value":"20"}],"variable":[]}},"response":[],"_postman_id":"e83e0199-3474-42e0-af92-260d6dcf23ef"},{"name":"Post Invoice (cliente autenticado)","id":"8fee481b-8769-4773-b864-3148e8bbae69","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"REEMPLAZAR_CON_TU_JWT"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_order_type\": 1,\n \"points_redeemed\": 0,\n \"name_customer\": \"Juan\",\n \"reward\": null,\n \"last_name_customer\": \"Perez\",\n \"id_customer_shopify\": null,\n \"rtn_customer\": \"0801-1990-123456\",\n \"total\": 250.00,\n \"order_transaccion_card\": null,\n \"order_number\": 0,\n \"discount_percent\": null,\n \"options_send\": { \"send_whatsapp\": true, \"send_mail\": true, \"phone_number\": \"+50499998888\", \"email\": \"juan.perez@example.com\" },\n \"shipping_address\": { \"name_address\": \"Casa\", \"address\": \"Col. Palmira\", \"address2\": \"Apto 4B\", \"city\": \"Tegucigalpa\", \"country\": \"Honduras\", \"postal_code\": \"11101\" },\n \"payment_methods\": [ { \"id_payment\": 1, \"total\": 250.00 } ],\n \"shopify_payment\": [],\n \"products\": [\n { \"id_product\": 10, \"name\": \"Hamburguesa Clasica\", \"quantity\": 2, \"price\": 100.00, \"id_discount\": null, \"value_discount\": 0, \"variation\": { \"id_variation\": 0 }, \"combined\": [] },\n { \"id_product\": null, \"name\": \"Envio\", \"quantity\": 1, \"price\": 50.00, \"id_discount\": null, \"value_discount\": 0, \"variation\": null, \"combined\": [] }\n ],\n \"id_establishment\": 0\n}"},"url":"https://api.yalocobro.com/api/v1/Invoices","description":"

Auth: JWT (Bearer). Crea una factura para el cliente autenticado. Devuelve { id_invoice, points }.

\n","urlObject":{"path":["api","v1","Invoices"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"8fee481b-8769-4773-b864-3148e8bbae69"},{"name":"Post Invoice Without Customer","id":"9a0fe2e6-cb43-402e-bb38-60be2a697e6b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_order_type\": 1,\n \"points_redeemed\": 0,\n \"name_customer\": null,\n \"reward\": null,\n \"last_name_customer\": null,\n \"id_customer_shopify\": null,\n \"rtn_customer\": \"0000-0000-000000\",\n \"total\": 150.00,\n \"order_transaccion_card\": null,\n \"order_number\": 0,\n \"discount_percent\": null,\n \"options_send\": { \"send_whatsapp\": false, \"send_mail\": false, \"phone_number\": null, \"email\": null },\n \"shipping_address\": null,\n \"payment_methods\": [ { \"id_payment\": 1, \"total\": 150.00 } ],\n \"shopify_payment\": [],\n \"products\": [ { \"id_product\": 10, \"name\": \"Hamburguesa Clasica\", \"quantity\": 1, \"price\": 150.00, \"id_discount\": null, \"value_discount\": 0, \"variation\": { \"id_variation\": 0 }, \"combined\": [] } ],\n \"id_establishment\": 0\n}"},"url":"https://api.yalocobro.com/api/v1/Invoices/WithoutCustomer","description":"

Auth: API Key (heredada). Crea una factura asignada al cliente 'Consumidor Final' de la organizacion.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"REEMPLAZAR_CON_TU_API_KEY"}]},"isInherited":true,"source":{"_postman_id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","name":"YaloCobro External API - Completa","type":"collection"}},"urlObject":{"path":["api","v1","Invoices","WithoutCustomer"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"9a0fe2e6-cb43-402e-bb38-60be2a697e6b"},{"name":"Post Invoice With Shopify Customer","id":"cc51b2db-398b-491f-b559-514cb3be41af","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_order_type\": 1,\n \"points_redeemed\": 0,\n \"name_customer\": \"Maria\",\n \"reward\": null,\n \"last_name_customer\": \"Lopez\",\n \"id_customer_shopify\": 7654321098765,\n \"rtn_customer\": \"0801-1985-654321\",\n \"total\": 320.00,\n \"order_transaccion_card\": null,\n \"order_number\": 1042,\n \"discount_percent\": null,\n \"options_send\": { \"send_whatsapp\": true, \"send_mail\": true, \"phone_number\": \"+50488887777\", \"email\": \"maria.lopez@example.com\" },\n \"shipping_address\": { \"name_address\": \"Oficina\", \"address\": \"Blvd. Morazan\", \"address2\": null, \"city\": \"Tegucigalpa\", \"country\": \"Honduras\", \"postal_code\": \"11101\" },\n \"payment_methods\": [ { \"id_payment\": 1, \"total\": 320.00 } ],\n \"shopify_payment\": [ { \"name\": [ \"Bank Deposit\" ] } ],\n \"products\": [\n { \"id_product\": 20, \"name\": \"Pizza Familiar\", \"quantity\": 1, \"price\": 270.00, \"id_discount\": null, \"value_discount\": 0, \"variation\": { \"id_variation\": 0 }, \"combined\": [] },\n { \"id_product\": null, \"name\": \"Envio\", \"quantity\": 1, \"price\": 50.00, \"id_discount\": null, \"value_discount\": 0, \"variation\": null, \"combined\": [] }\n ],\n \"id_establishment\": 0\n}"},"url":"https://api.yalocobro.com/api/v1/Invoices/WithShopifyCustomer","description":"

Auth: API Key (heredada). Crea/actualiza el cliente Shopify (match por id_customer_shopify, nombre, telefono o email) y crea la factura. Rechaza order_number duplicado. Si shopify_payment.name = 'Bank Deposit', usa 'Transferencia'.

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"REEMPLAZAR_CON_TU_API_KEY"}]},"isInherited":true,"source":{"_postman_id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","name":"YaloCobro External API - Completa","type":"collection"}},"urlObject":{"path":["api","v1","Invoices","WithShopifyCustomer"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"cc51b2db-398b-491f-b559-514cb3be41af"}],"id":"126ae203-b584-4a4e-8df7-9669000a3e08","_postman_id":"126ae203-b584-4a4e-8df7-9669000a3e08","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"REEMPLAZAR_CON_TU_API_KEY"}]},"isInherited":true,"source":{"_postman_id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","name":"YaloCobro External API - Completa","type":"collection"}}},{"name":"MarketMan (Inventario)","item":[{"name":"Credentials — alta/actualización","id":"81bdcf11-1f81-4b70-89ce-099dce59b186","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"REEMPLAZAR_CON_TU_JWT"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"cod_establecimiento\": null,\n \"api_key\": \"TU_API_KEY_DE_MARKETMAN\",\n \"api_password\": \"TU_API_PASSWORD_DE_MARKETMAN\",\n \"habilitado\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.yalocobro.com/api/v1/MarketMan/Credentials","description":"

Registra o actualiza las credenciales de MarketMan de la organización autenticada. Se guardan cifradas (AES).

cod_establecimiento (opcional): credencial por establecimiento; null = a nivel organización.
habilitado: si es true, las facturas de la organización empiezan a encolarse para sincronizar.

\n","urlObject":{"path":["api","v1","MarketMan","Credentials"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[{"id":"bd08b618-31e0-4bcc-8c85-46d3bade8a8d","name":"200 OK","originalRequest":{"auth":{"type":"bearer","bearer":{"token":"REEMPLAZAR_CON_TU_JWT"}},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"cod_establecimiento\": null,\n \"api_key\": \"TU_API_KEY_DE_MARKETMAN\",\n \"api_password\": \"TU_API_PASSWORD_DE_MARKETMAN\",\n \"habilitado\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.yalocobro.com/api/v1/MarketMan/Credentials","description":"Registra o actualiza las credenciales de MarketMan de la organización autenticada. Se guardan **cifradas (AES)**.\n\n- `cod_establecimiento` (opcional): credencial por establecimiento; `null` = a nivel organización.\n- `habilitado`: si es `true`, las facturas de la organización empiezan a encolarse para sincronizar."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Credenciales guardadas.\",\n \"cod_credencial\": 12\n}"}],"_postman_id":"81bdcf11-1f81-4b70-89ce-099dce59b186"},{"name":"Status — estado de una factura","id":"ae1cc027-e535-4045-97e6-3e9e8f23dd0c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"REEMPLAZAR_CON_TU_JWT"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.yalocobro.com/api/v1/MarketMan/Status/:codFactura","description":"

Estado de sincronización de una factura: estado, intentos, mensaje_error, marketman_ref, fecha_creacion, fecha_envio. Devuelve 404 si la factura nunca se encoló.

\n","urlObject":{"path":["api","v1","MarketMan","Status",":codFactura"],"host":["https://api.yalocobro.com"],"query":[],"variable":[{"id":"867f85ac-62b7-4dd7-b7be-637267ad975a","description":{"content":"

Código de la factura (FacFactura.Codfactura).

\n","type":"text/plain"},"type":"any","value":"12345","key":"codFactura"}]}},"response":[{"id":"11002f1d-749a-4ad6-80f7-9a7d75d8a409","name":"200 OK","originalRequest":{"auth":{"type":"bearer","bearer":{"token":"REEMPLAZAR_CON_TU_JWT"}},"method":"GET","header":[],"url":{"raw":"https://api.yalocobro.com/api/v1/MarketMan/Status/:codFactura","host":["https://api.yalocobro.com"],"path":["api","v1","MarketMan","Status",":codFactura"],"variable":[{"id":"867f85ac-62b7-4dd7-b7be-637267ad975a","key":"codFactura","value":"12345","description":"Código de la factura (FacFactura.Codfactura)."}]},"description":"Estado de sincronización de una factura: `estado`, `intentos`, `mensaje_error`, `marketman_ref`, `fecha_creacion`, `fecha_envio`. Devuelve `404` si la factura nunca se encoló."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"cod_factura\": 12345,\n \"estado\": \"enviado\",\n \"intentos\": 1,\n \"mensaje_error\": null,\n \"marketman_ref\": \"MM-998877\",\n \"fecha_creacion\": \"2026-06-16T10:15:00\",\n \"fecha_envio\": \"2026-06-16T10:15:21\"\n}"}],"_postman_id":"ae1cc027-e535-4045-97e6-3e9e8f23dd0c"},{"name":"Resync — reenviar una factura","id":"33ab99cc-5e2a-4f95-99ec-41e1624e556e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"REEMPLAZAR_CON_TU_JWT"}]},"isInherited":false},"method":"POST","header":[],"url":"https://api.yalocobro.com/api/v1/MarketMan/Resync/:codFactura","description":"

Reenvío manual: deja la factura en estado pendiente para que el worker la reprocese. Si nunca se encoló, crea la fila a partir de la factura. Útil cuando quedó en error.

\n","urlObject":{"path":["api","v1","MarketMan","Resync",":codFactura"],"host":["https://api.yalocobro.com"],"query":[],"variable":[{"id":"410d1c12-3a13-47a9-bb6a-598f394bf37e","description":{"content":"

Código de la factura a reenviar.

\n","type":"text/plain"},"type":"any","value":"12345","key":"codFactura"}]}},"response":[{"id":"8179b342-0ee8-4073-9dab-040025412d7b","name":"200 OK","originalRequest":{"auth":{"type":"bearer","bearer":{"token":"REEMPLAZAR_CON_TU_JWT"}},"method":"POST","header":[],"url":{"raw":"https://api.yalocobro.com/api/v1/MarketMan/Resync/:codFactura","host":["https://api.yalocobro.com"],"path":["api","v1","MarketMan","Resync",":codFactura"],"variable":[{"id":"410d1c12-3a13-47a9-bb6a-598f394bf37e","key":"codFactura","value":"12345","description":"Código de la factura a reenviar."}]},"description":"Reenvío manual: deja la factura en estado `pendiente` para que el worker la reprocese. Si nunca se encoló, crea la fila a partir de la factura. Útil cuando quedó en `error`."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Factura reencolada para MarketMan.\",\n \"cod_factura\": 12345\n}"}],"_postman_id":"33ab99cc-5e2a-4f95-99ec-41e1624e556e"},{"name":"Resync — reenviar lote (en error)","id":"5327575a-babd-457e-9c93-bbf29fd39923","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"REEMPLAZAR_CON_TU_JWT"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"desde\": \"2026-06-01T00:00:00\",\n \"hasta\": \"2026-06-16T23:59:59\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.yalocobro.com/api/v1/MarketMan/Resync","description":"

Reencola todas las facturas en estado error de la organización. El rango desde/hasta es opcional (filtra por fecha_creacion).

\n","urlObject":{"path":["api","v1","MarketMan","Resync"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[{"id":"1e3178d3-b01c-4b6c-a108-33f1b593ee16","name":"200 OK","originalRequest":{"auth":{"type":"bearer","bearer":{"token":"REEMPLAZAR_CON_TU_JWT"}},"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"desde\": \"2026-06-01T00:00:00\",\n \"hasta\": \"2026-06-16T23:59:59\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.yalocobro.com/api/v1/MarketMan/Resync","description":"Reencola todas las facturas en estado `error` de la organización. El rango `desde`/`hasta` es opcional (filtra por `fecha_creacion`)."},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Facturas reencoladas.\",\n \"total\": 7\n}"}],"_postman_id":"5327575a-babd-457e-9c93-bbf29fd39923"}],"id":"f0372f3b-d473-4053-bd3d-b15d0ebc0271","description":"

StartFragment

Integración Yalo + MarketMan — ¿Cómo funciona?

Esta integración conecta tu sistema de ventas Yalo con tu plataforma de inventario MarketMan, para que tu inventario se mantenga actualizado automáticamente con cada venta.

¿Qué hace por ti?

Cada vez que se emite una factura en Yalo, los productos vendidos se descuentan automáticamente del inventario en MarketMan. No tienes que registrar nada a mano ni exportar archivos: la venta viaja sola hacia MarketMan.

En una frase: vendes en Yalo y tu inventario en MarketMan se actualiza solo.

¿Cómo funciona, en simple?

Flujo de la integración

Vendes. Se genera la factura en Yalo, como siempre.
\n
Se anota el envío. La venta queda registrada en una \"cola\" para enviarse a MarketMan.
\n
Se envía a MarketMan. Un proceso automático toma esa venta y le informa a MarketMan qué se consumió.
\n
Queda registrado. Cada venta muestra su estado: enviado ✅ o con error ⚠️ (para reintentar).
\n

Todo esto ocurre en segundo plano, sin afectar la rapidez de tu caja.

¿Qué necesitas para activarla?

Tus credenciales de MarketMan (API Key y API Password), que se obtienen desde tu cuenta de MarketMan. Las cargamos una sola vez.
\n
La equivalencia de productos: indicar qué producto de Yalo corresponde a cada artículo en MarketMan, para descontar lo correcto.
\n

Una vez configurado, no hay nada más que hacer del lado operativo.

Preguntas frecuentes

¿Qué pasa si MarketMan está caído o hay un problema de internet? La venta no se ve afectada y no se pierde nada. El envío queda en cola y se reintenta automáticamente hasta lograrlo. Tu operación de caja nunca se detiene por MarketMan.

¿Puedo reenviar una venta manualmente? Sí. Si alguna venta quedó marcada con error, se puede reenviar con un clic (o desde el endpoint correspondiente) sin tener que rehacer nada.

¿Cómo sé si una venta ya se sincronizó? Cada venta tiene un estado: pendiente, enviado o con error. Así siempre sabes qué llegó a MarketMan.

¿Es seguro? ¿Dónde quedan mis credenciales? Sí. Tus credenciales de MarketMan se guardan cifradas y se usan únicamente para enviar tus ventas a tu propia cuenta de MarketMan. Cada cliente usa sus propias credenciales; no se mezclan datos entre clientes.

¿Afecta el rendimiento de mi punto de venta? No. El envío a MarketMan se hace por separado, después de cerrar la venta, así que la caja sigue igual de rápida.

¿Qué envía exactamente a MarketMan?

Por cada venta se envía el consumo de los productos (qué artículo y qué cantidad), para que MarketMan descuente el inventario. No se envía información sensible de pago.

Integración con MarketMan API V3: al facturar, el consumo de productos se envía (push) a MarketMan para descontar inventario.

El envío es asíncrono (patrón outbox + worker), así que la facturación nunca se bloquea por MarketMan. Cada factura tiene un estado: pendiente → procesando → enviado | error (reintenta hasta 5 veces).

Autenticación: JWT Bearer (REEMPLAZAR_CON_TU_JWT).

Puesta en marcha: 1) cargar credenciales (POST Credentials), 2) poblar el mapeo de productos, 3) facturar y verificar con GET Status.

EndFragment

\n","_postman_id":"f0372f3b-d473-4053-bd3d-b15d0ebc0271","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"REEMPLAZAR_CON_TU_API_KEY"}]},"isInherited":true,"source":{"_postman_id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","name":"YaloCobro External API - Completa","type":"collection"}}},{"name":"Table Map (Mesas / Reservaciones) [rama feature]","item":[{"name":"Get Maps","id":"842d9879-77ff-4d05-b51f-386651954e7e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.yalocobro.com/api/v1/TableMap/Maps?id_establishment=1","description":"

Auth: API Key. [Pendiente de merge: feature/table-map-kitchen-monitor-endpoints] Mapas/planos del establecimiento con sus mesas y estado (free/occupied).

Auth: API Key. Mesas con su estado de ocupacion actual.

Auth: API Key. Mesas disponibles para fecha/hora y numero de personas (ventana +/- 2h).

Auth: API Key. Lista reservaciones (date opcional).

Auth: API Key. Crea reservacion (cliente por id_customer o phone_number).

Auth: API Key. Cancela una reservacion.

Auth: API Key. Marca una reservacion como finalizada.

Auth: API Key. Ocupa una mesa. 409 si ya esta ocupada.

Auth: API Key. Libera la mesa y registra minutos usados.

Auth: API Key. [Pendiente de merge: feature/table-map-kitchen-monitor-endpoints] Catalogo de estados de orden.

Auth: API Key. Ordenes de cocina/despacho con estado actual, productos e historial.

Auth: API Key. Cambia el estado de una orden (preparando -> listo -> entregado), registra bitacora, emite push SignalR y devuelve datos de contacto del cliente.

Sin auth. Verifica conectividad a ambas bases (YaloCobro y YaloAUTH). 200 OK si ambas responden.

\n","urlObject":{"path":["api","Health"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"2df6312d-a9aa-4f1f-8779-33e001616375"},{"name":"Secret Status","id":"adb47af9-a5b5-4dfa-9341-cb7f2e003d7d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://api.yalocobro.com/api/Health/secret-status","description":"

Sin auth. Estado de configuracion/secretos (valores sensibles enmascarados).

\n","urlObject":{"path":["api","Health","secret-status"],"host":["https://api.yalocobro.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"adb47af9-a5b5-4dfa-9341-cb7f2e003d7d"}],"id":"4e683b89-3edf-4fa3-b9e1-68c764d66fe1","_postman_id":"4e683b89-3edf-4fa3-b9e1-68c764d66fe1","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"REEMPLAZAR_CON_TU_API_KEY"}]},"isInherited":true,"source":{"_postman_id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","id":"b5f52e5f-77d2-49de-b824-3e2838e53e24","name":"YaloCobro External API - Completa","type":"collection"}}}],"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"api-key"},{"key":"value","value":"REEMPLAZAR_CON_TU_API_KEY"}]}},"variable":[{"key":"base_url","value":"https://api.yalocobro.com"},{"key":"api_key","value":"REEMPLAZAR_CON_TU_API_KEY"},{"key":"jwt_token","value":"REEMPLAZAR_CON_TU_JWT"}]}