{ "item": [ { "id": "1cf8aa8f-bed6-46b5-8fcc-8c66f01e7c5b", "name": "Catálogos", "description": { "content": "Países", "type": "text/plain" }, "item": [ { "id": "48e16972-58bc-4f17-a189-72187a3d55fa", "name": "get Countries", "request": { "name": "get Countries", "description": { "content": "Obtiene los paises \n\n- Puede hacer filto por código de país o por nombre, estos se pasan en los query params\n", "type": "text/plain" }, "url": { "path": [ "v3", "api", "cnf", "countries" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "countryCode", "value": "", "description": "código del país" }, { "disabled": false, "key": "name", "value": "", "description": "nombre del país" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET" }, "response": [ { "id": "794f3579-9eb1-465e-b520-b4c5cdceac02", "name": "configuracion de bono por id de comercio", "originalRequest": { "url": { "path": [ "v3", "api", "cnf", "countries" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "countryCode", "value": "CO" }, { "key": "name", "value": "Colombia" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"value\": \"" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b3d4db1a-6ea3-4333-81c2-c20eff8de463", "name": "Error buscando la configuracion", "originalRequest": { "url": { "path": [ "v3", "api", "cnf", "countries" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "countryCode", "value": "CO" }, { "key": "name", "value": "Colombia" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "aaa45614-679c-4445-a5e3-4feb1f9a6604", "name": "get Cities By Country", "request": { "name": "get Cities By Country", "description": { "content": "Obtiene las ciudades de un país\n\ntiene filtro por nombre de la ciudad\n", "type": "text/plain" }, "url": { "path": [ "v3", "api", "cnf", "cities", ":countryCode" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "name", "value": "", "description": "nombre de la cudad" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "countryCode", "description": "(Required) código del país" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET" }, "response": [ { "id": "7c81c343-76c2-46b2-9116-6b83e78d6558", "name": "configuracion de bono por id de comercio", "originalRequest": { "url": { "path": [ "v3", "api", "cnf", "cities", ":countryCode" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "name", "value": "Medellín" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "countryCode", "description": "(Required) código del país" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"value\": \"", "key": "countryCode", "description": "(Required) código del país" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "585b5fa9-d723-4d60-b8e9-1a6cdaf3a99e", "name": "Error buscando la configuracion", "originalRequest": { "url": { "path": [ "v3", "api", "cnf", "cities", ":countryCode" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "name", "value": "Medellín" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "countryCode", "description": "(Required) código del país" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "66fe22be-7d98-4a26-b035-0ec7d999c746", "name": "get Document Type", "request": { "name": "get Document Type", "description": { "content": "Obtiene la moneda de un país", "type": "text/plain" }, "url": { "path": [ "v3", "api", "cnf", "document-type", ":countryCode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "countryCode", "description": "(Required) código del país" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET" }, "response": [ { "id": "5020c067-fa96-441a-a8e8-b06efac93596", "name": "configuracion de bono por id de comercio", "originalRequest": { "url": { "path": [ "v3", "api", "cnf", "document-type", ":countryCode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "countryCode", "description": "(Required) código del país" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"value\": \"", "key": "countryCode", "description": "(Required) código del país" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5c7e4dec-54a5-44c2-8dcc-7b1466b75207", "name": "Error buscando la configuracion", "originalRequest": { "url": { "path": [ "v3", "api", "cnf", "document-type", ":countryCode" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "countryCode", "description": "(Required) código del país" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "3636da4a-8421-4d32-b66b-b6f52ce3a888", "name": "Registro", "description": { "content": "Alta de un usuario en el comercio.", "type": "text/plain" }, "item": [ { "id": "2295c72f-1673-42a7-87bb-3d7c0c2b2558", "name": "registro Unificado", "request": { "name": "registro Unificado", "description": { "content": "Registra un usuario\n\nAlta de un usuario. Exige `codPais`, `codCiudad`, `plataformaOrigen` y `tipoDocumento`,\ny al menos uno entre `cedula` y `celular`.", "type": "text/plain" }, "url": { "path": [ "v3", "usuarios", "identidad", "registro" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"codPais\": \"\",\n \"codCiudad\": \"\",\n \"plataformaOrigen\": \"\",\n \"tipoDocumento\": \"\",\n \"cedula\": \"\",\n \"celular\": \"\",\n \"nombre\": \"\",\n \"apellido\": \"\",\n \"email\": \"\",\n \"idComercio\": \"\",\n \"idSucursalRegistro\": \"\",\n \"genero\": \"\",\n \"cumpleanos\": \"\",\n \"tipoRegistro\": \"\",\n \"channelValidation\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "8143eb39-a054-4096-9fc1-72e86703f9b0", "name": "Usuario registrado", "originalRequest": { "url": { "path": [ "v3", "usuarios", "identidad", "registro" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"codPais\": \"\",\n \"codCiudad\": \"\",\n \"plataformaOrigen\": \"\",\n \"tipoDocumento\": \"\",\n \"cedula\": \"\",\n \"celular\": \"\",\n \"nombre\": \"\",\n \"apellido\": \"\",\n \"email\": \"\",\n \"idComercio\": \"\",\n \"idSucursalRegistro\": \"\",\n \"genero\": \"\",\n \"cumpleanos\": \"\",\n \"tipoRegistro\": \"\",\n \"channelValidation\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"string\",\n \"data\": {\n \"uid\": \"string\",\n \"token\": \"string\",\n \"refreshToken\": \"string\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0e609c43-0e22-4c3f-8c7f-e063fbb05e6a", "name": "Validación rechazada o el usuario ya existe", "originalRequest": { "url": { "path": [ "v3", "usuarios", "identidad", "registro" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"codPais\": \"\",\n \"codCiudad\": \"\",\n \"plataformaOrigen\": \"\",\n \"tipoDocumento\": \"\",\n \"cedula\": \"\",\n \"celular\": \"\",\n \"nombre\": \"\",\n \"apellido\": \"\",\n \"email\": \"\",\n \"idComercio\": \"\",\n \"idSucursalRegistro\": \"\",\n \"genero\": \"\",\n \"cumpleanos\": \"\",\n \"tipoRegistro\": \"\",\n \"channelValidation\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "2b9e393d-1015-4028-9026-527119b5fe60", "name": "channelValidation no es SMS, EMAIL ni WSP", "originalRequest": { "url": { "path": [ "v3", "usuarios", "identidad", "registro" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"codPais\": \"\",\n \"codCiudad\": \"\",\n \"plataformaOrigen\": \"\",\n \"tipoDocumento\": \"\",\n \"cedula\": \"\",\n \"celular\": \"\",\n \"nombre\": \"\",\n \"apellido\": \"\",\n \"email\": \"\",\n \"idComercio\": \"\",\n \"idSucursalRegistro\": \"\",\n \"genero\": \"\",\n \"cumpleanos\": \"\",\n \"tipoRegistro\": \"\",\n \"channelValidation\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "c10894ff-a848-45af-a372-ea1656c2183a", "name": "Error interno", "originalRequest": { "url": { "path": [ "v3", "usuarios", "identidad", "registro" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"codPais\": \"\",\n \"codCiudad\": \"\",\n \"plataformaOrigen\": \"\",\n \"tipoDocumento\": \"\",\n \"cedula\": \"\",\n \"celular\": \"\",\n \"nombre\": \"\",\n \"apellido\": \"\",\n \"email\": \"\",\n \"idComercio\": \"\",\n \"idSucursalRegistro\": \"\",\n \"genero\": \"\",\n \"cumpleanos\": \"\",\n \"tipoRegistro\": \"\",\n \"channelValidation\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "3c00e693-9a39-432a-b2b1-3658191a0830", "name": "Sucursales", "description": { "content": "Sucursales del comercio.", "type": "text/plain" }, "item": [ { "id": "3135ea7c-f997-49f4-831c-7ad932dabb65", "name": "get Branches By Commerce360", "request": { "name": "get Branches By Commerce360", "description": { "content": "Servicio para obtener la información detallada de una sucursal específica de un comercio.", "type": "text/plain" }, "url": { "path": [ "v2", "crm", "api", "configuration", "v1", "commerce", ":commerce_id", "branches" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "uid_cms", "value": "", "description": "(Required) ID único del usuario en CMS." }, { "disabled": false, "key": "word", "value": "", "description": "filtro del nombre de la sucursal" }, { "disabled": false, "key": "franchise", "value": "", "description": "filtro de franquisia" } ], "variable": [ { "disabled": false, "type": "any", "value": "{{commerceId}}", "key": "commerce_id", "description": "(Required) ID del comercio." } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET" }, "response": [ { "id": "04dc1efc-9e5f-4142-bbaf-fbc7e2d1e0b0", "name": "Información de la sucursal obtenida exitosamente.", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "configuration", "v1", "commerce", ":commerce_id", "branches" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "uid_cms", "value": "" }, { "key": "word", "value": "" }, { "key": "franchise", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"string\",\n \"message\": \"ok\",\n \"data\": {\n \"address\": \"Av. 68 #75A - 50\",\n \"branch_id\": 55172,\n \"city_id\": 1,\n \"commerce_id\": 3,\n \"cod_pais\": \"CO\",\n \"credibanco_code\": \"00016231185\",\n \"email\": \"email@email1.com\",\n \"external_id\": \"\",\n \"franchise_id\": 0,\n \"is_virtual_branch\": false,\n \"latitude\": 4.680574955013558,\n \"longitude\": -74.08218520546262,\n \"name\": \"Sucursal Centro\",\n \"phone_number\": \"0313778669\",\n \"created_at\": \"2024-11-19 15:00:07\",\n \"schedule\": {\n \"monday\": \"always_open\",\n \"tuesday\": \"08:00:00-17:00:00\",\n \"wednesday\": \"08:00:00-17:00:00\",\n \"thursday\": \"08:00:00-17:00:00\",\n \"friday\": \"08:00:00-17:00:00\",\n \"saturday\": \"10:00:00-14:00:00\",\n \"sunday\": \"close\"\n },\n \"status\": \"activa\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1e0d6105-bf68-4c8f-a192-e1d55bef4bbf", "name": "No autorizado. Token no válido o ausente.", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "configuration", "v1", "commerce", ":commerce_id", "branches" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "uid_cms", "value": "" }, { "key": "word", "value": "" }, { "key": "franchise", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"Unauthorized\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8746d103-f4a5-45ae-b101-fe457159035d", "name": "Comercio o sucursal no encontrados.", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "configuration", "v1", "commerce", ":commerce_id", "branches" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "uid_cms", "value": "" }, { "key": "word", "value": "" }, { "key": "franchise", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"string\",\n \"message\": \"datos incorrectos\",\n \"data\": {\n \"code\": \"invalidData\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e6f9e276-08b4-4ab7-b260-8d8337abe23e", "name": "Error interno del servidor.", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "configuration", "v1", "commerce", ":commerce_id", "branches" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "uid_cms", "value": "" }, { "key": "word", "value": "" }, { "key": "franchise", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio." } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": \"string\",\n \"message\": \"datos incorrectos\",\n \"data\": {\n \"code\": \"invalidData\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "7f06ec85-2711-4cc5-9f29-9ddb42108000", "name": "Consulta", "description": { "content": "Búsqueda y perfil del usuario.", "type": "text/plain" }, "item": [ { "id": "fc4f79ec-c384-46a7-90fb-def0f3d1ca8c", "name": "consultar Usuario Criterio", "request": { "name": "consultar Usuario Criterio", "description": { "content": "Busca un usuario por criterio\n\nBusca un usuario. Con `criterio` `tipo+doc`, `valor` se parte por `#`.\nSi hay usuario, `code` es 100 y la respuesta trae `uid`.", "type": "text/plain" }, "url": { "path": [ "v3", "users", "legacy", "consultar-usuario-criterio" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"criterio\": \"\",\n \"valor\": \"\",\n \"complemento\": \"\",\n \"valorComplemento\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "106178e2-c839-4701-8c32-2bb67bbfc2e9", "name": "Usuario encontrado o no encontrado (`code` 103)", "originalRequest": { "url": { "path": [ "v3", "users", "legacy", "consultar-usuario-criterio" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"criterio\": \"\",\n \"valor\": \"\",\n \"complemento\": \"\",\n \"valorComplemento\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": 1799,\n \"message\": \"string\",\n \"uid\": \"string\",\n \"data\": {}\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "3c85768d-6d24-45ee-9949-d5c9477d4463", "name": "perfil Usuario", "request": { "name": "perfil Usuario", "description": { "content": "Obtiene el perfil del usuario\n\nDevuelve el perfil del `uid` de la ruta. `code` 100 y `data` con los datos del usuario.", "type": "text/plain" }, "url": { "path": [ "v3", "users", "legacy", ":uid", "perfil" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "uid", "description": "(Required) " } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET" }, "response": [ { "id": "a6ea5096-805c-47d5-8d42-58139d499648", "name": "Perfil del usuario", "originalRequest": { "url": { "path": [ "v3", "users", "legacy", ":uid", "perfil" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "uid", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": 1799,\n \"message\": \"string\",\n \"uid\": \"string\",\n \"data\": {}\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "e4e985a4-8f6c-434a-a9f9-69c278d06e3b", "name": "Asociación", "description": { "content": "Alta y baja del usuario en el comercio.", "type": "text/plain" }, "item": [ { "id": "e9ab7f49-fc0a-4d2c-9fec-48cccb3e5d10", "name": "agregar Favorito", "request": { "name": "agregar Favorito", "description": { "content": "Asocia el usuario al comercio\n\nAsocia el usuario al comercio. `uid` e `idComercio` son obligatorios.\n`code` 100 devuelve `data.user_status`, `data.welcome_points` y `data.accum_point`.", "type": "text/plain" }, "url": { "path": [ "v3", "users", "legacy", "favorite", "add" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"uid\": \"\",\n \"idComercio\": \"\",\n \"send_welcome_email\": \"\",\n \"origin_reference\": \"\",\n \"origin_reference_marketing\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "6127ce91-3a5c-43db-bbfe-368f122b9eb4", "name": "Asociación aplicada", "originalRequest": { "url": { "path": [ "v3", "users", "legacy", "favorite", "add" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"uid\": \"\",\n \"idComercio\": \"\",\n \"send_welcome_email\": \"\",\n \"origin_reference\": \"\",\n \"origin_reference_marketing\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": 1799,\n \"message\": \"string\",\n \"uid\": \"string\",\n \"data\": {}\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ec84dfd9-78bc-47e9-bdf9-9c2b888daf39", "name": "quitar Favorito", "request": { "name": "quitar Favorito", "description": { "content": "Quita al usuario del comercio\n\nQuita al usuario del comercio. `uid` y `commerce_id` son obligatorios.\n`code` 100 devuelve `data.user_status`.", "type": "text/plain" }, "url": { "path": [ "v3", "users", "legacy", "favorite", "remove" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"uid\": \"\",\n \"commerce_id\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "fcb06b24-6731-4e1d-8ad9-7b0db49b3604", "name": "Asociación retirada", "originalRequest": { "url": { "path": [ "v3", "users", "legacy", "favorite", "remove" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PUT", "body": { "mode": "raw", "raw": "{\n \"uid\": \"\",\n \"commerce_id\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"code\": 1799,\n \"message\": \"string\",\n \"uid\": \"string\",\n \"data\": {}\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "87aacf85-1ccb-47e5-8caa-64335492cb7f", "name": "Comercio", "description": { "content": "Comercio de la API key.", "type": "text/plain" }, "item": [ { "id": "963719a5-bb98-4d83-81e4-a0ce1a030faf", "name": "public Whoami", "request": { "name": "public Whoami", "description": { "content": "Resolve AuthContext tenancy", "type": "text/plain" }, "url": { "path": [ "v1", "loyalty", "public", "whoami" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "api_version", "value": "", "description": "Versión de la API. Úsala si no envías el header X-API-Version. Si van los dos, manda el header." } ], "variable": [] }, "header": [ { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "" }, { "disabled": false, "description": "Comercio de la operación, cuando la credencial cubre más de uno.", "key": "X-Declared-Commerce-Id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET" }, "response": [ { "id": "2ce5c4db-c390-423f-81f9-8bd6842ff62f", "name": "Auth context", "originalRequest": { "url": { "path": [ "v1", "loyalty", "public", "whoami" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_version", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "1" }, { "disabled": false, "description": "Comercio de la operación, cuando la credencial cubre más de uno.", "key": "X-Declared-Commerce-Id", "value": "630" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"commerce_id\": 630,\n \"credential_id\": \"11111111-1111-1111-1111-111111111111\",\n \"actor_kind\": \"commerce\",\n \"export_detail\": \"cleartext\",\n \"api_version\": \"1\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2950c83d-6e62-48f9-978a-7d5effbb190d", "name": "Problem details", "originalRequest": { "url": { "path": [ "v1", "loyalty", "public", "whoami" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_version", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "1" }, { "disabled": false, "description": "Comercio de la operación, cuando la credencial cubre más de uno.", "key": "X-Declared-Commerce-Id", "value": "630" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"status\": 9140,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"code\": \"string\",\n \"retryable\": true,\n \"family\": \"string\",\n \"catalog_version\": 8295,\n \"retry_after\": 9764\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "d2f98d45-47f8-4937-8c6a-c5bb54a066e6", "name": "Saldo", "description": { "content": "Saldo y movimientos del cliente.", "type": "text/plain" }, "item": [ { "id": "a692a9fe-f490-457a-b993-e36180dc497c", "name": "public Get Balances", "request": { "name": "public Get Balances", "description": { "content": "Get member active and pending balances", "type": "text/plain" }, "url": { "path": [ "v1", "loyalty", "public", "balances" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "api_version", "value": "", "description": "Versión de la API. Úsala si no envías el header X-API-Version. Si van los dos, manda el header." }, { "disabled": false, "key": "member_ref", "value": "", "description": "(Required) " }, { "disabled": false, "key": "commerce_id", "value": "", "description": "Optional; when present must match AuthContext tenant" } ], "variable": [] }, "header": [ { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET" }, "response": [ { "id": "ff683569-3e6e-4b3d-88ae-cce158933cba", "name": "Balance snapshot (zeros when empty — A-8)", "originalRequest": { "url": { "path": [ "v1", "loyalty", "public", "balances" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_version", "value": "1" }, { "key": "member_ref", "value": "" }, { "key": "commerce_id", "value": "630" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "1" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"commerce_id\": 630,\n \"member_ref\": \"member-demo-001\",\n \"active_balance\": 0,\n \"pending_balances\": [],\n \"as_of\": \"2026-09-28T15:00:00Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2c85525d-cad7-4a9f-ab70-9e0b5d4f2901", "name": "Problem details", "originalRequest": { "url": { "path": [ "v1", "loyalty", "public", "balances" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_version", "value": "1" }, { "key": "member_ref", "value": "" }, { "key": "commerce_id", "value": "630" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "1" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"status\": 9140,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"code\": \"string\",\n \"retryable\": true,\n \"family\": \"string\",\n \"catalog_version\": 8295,\n \"retry_after\": 9764\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "da6bcda0-136c-4d19-a2dd-a09484c7568c", "name": "Tenant mismatch", "originalRequest": { "url": { "path": [ "v1", "loyalty", "public", "balances" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_version", "value": "1" }, { "key": "member_ref", "value": "" }, { "key": "commerce_id", "value": "630" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "1" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"status\": 9140,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"code\": \"string\",\n \"retryable\": true,\n \"family\": \"string\",\n \"catalog_version\": 8295,\n \"retry_after\": 9764\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "795e6d64-1932-466c-9a8e-b524dd6824e0", "name": "Commerce not migrated / business state", "originalRequest": { "url": { "path": [ "v1", "loyalty", "public", "balances" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_version", "value": "1" }, { "key": "member_ref", "value": "" }, { "key": "commerce_id", "value": "630" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "1" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"status\": 9140,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"code\": \"string\",\n \"retryable\": true,\n \"family\": \"string\",\n \"catalog_version\": 8295,\n \"retry_after\": 9764\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "9e326cfa-3fff-4436-aacb-3c3e4730dabc", "name": "public List Movements", "request": { "name": "public List Movements", "description": { "content": "List member ledger movements", "type": "text/plain" }, "url": { "path": [ "v1", "loyalty", "public", "movements" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "api_version", "value": "", "description": "Versión de la API. Úsala si no envías el header X-API-Version. Si van los dos, manda el header." }, { "disabled": false, "key": "member_ref", "value": "", "description": "(Required) " }, { "disabled": false, "key": "from", "value": "" }, { "disabled": false, "key": "to", "value": "" }, { "disabled": false, "key": "page_size", "value": "50" }, { "disabled": false, "key": "cursor", "value": "" }, { "disabled": false, "key": "commerce_id", "value": "" } ], "variable": [] }, "header": [ { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET" }, "response": [ { "id": "a9836028-a2ea-429a-ae86-facd372fc6c2", "name": "Movement page (empty items when none)", "originalRequest": { "url": { "path": [ "v1", "loyalty", "public", "movements" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_version", "value": "1" }, { "key": "member_ref", "value": "" }, { "key": "from", "value": "" }, { "key": "to", "value": "" }, { "key": "page_size", "value": "50" }, { "key": "cursor", "value": "" }, { "key": "commerce_id", "value": "630" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "1" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"items\": [\n {\n \"entry_id\": \"09be45ce-24d1-ed8e-3a44-e0ce1445b1c4\",\n \"transaction_type\": \"string\",\n \"amount\": 6645,\n \"created_at\": \"1947-05-17T08:38:34.017Z\",\n \"member_ref\": \"string\",\n \"multiplier_factor\": 2214.506016124296,\n \"multiplier_applied\": false,\n \"non_delivery_reason\": \"string\",\n \"ceiling_applied\": true,\n \"clipped_amount\": 5326\n },\n {\n \"entry_id\": \"b325f758-947d-5abe-bd86-4a87b5efd45a\",\n \"transaction_type\": \"string\",\n \"amount\": 3604,\n \"created_at\": \"1951-12-21T06:01:52.858Z\",\n \"member_ref\": \"string\",\n \"multiplier_factor\": 8084.887330165576,\n \"multiplier_applied\": false,\n \"non_delivery_reason\": \"string\",\n \"ceiling_applied\": false,\n \"clipped_amount\": 9248\n }\n ],\n \"next_cursor\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1e943f23-a6fd-4e59-ac23-6ec0e6070706", "name": "Invalid page_size or date range (>90d)", "originalRequest": { "url": { "path": [ "v1", "loyalty", "public", "movements" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_version", "value": "1" }, { "key": "member_ref", "value": "" }, { "key": "from", "value": "" }, { "key": "to", "value": "" }, { "key": "page_size", "value": "50" }, { "key": "cursor", "value": "" }, { "key": "commerce_id", "value": "630" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "1" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"status\": 9140,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"code\": \"string\",\n \"retryable\": true,\n \"family\": \"string\",\n \"catalog_version\": 8295,\n \"retry_after\": 9764\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6711a66a-c16d-4327-8a44-838add139460", "name": "Problem details", "originalRequest": { "url": { "path": [ "v1", "loyalty", "public", "movements" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_version", "value": "1" }, { "key": "member_ref", "value": "" }, { "key": "from", "value": "" }, { "key": "to", "value": "" }, { "key": "page_size", "value": "50" }, { "key": "cursor", "value": "" }, { "key": "commerce_id", "value": "630" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "1" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"status\": 9140,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"code\": \"string\",\n \"retryable\": true,\n \"family\": \"string\",\n \"catalog_version\": 8295,\n \"retry_after\": 9764\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "357cbb99-dfd8-4258-8377-523cc280d62b", "name": "Tenant mismatch", "originalRequest": { "url": { "path": [ "v1", "loyalty", "public", "movements" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_version", "value": "1" }, { "key": "member_ref", "value": "" }, { "key": "from", "value": "" }, { "key": "to", "value": "" }, { "key": "page_size", "value": "50" }, { "key": "cursor", "value": "" }, { "key": "commerce_id", "value": "630" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "1" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "GET", "body": {} }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"status\": 9140,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"code\": \"string\",\n \"retryable\": true,\n \"family\": \"string\",\n \"catalog_version\": 8295,\n \"retry_after\": 9764\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "5768f07f-0c06-4aae-a669-58c6b4268e4a", "name": "Acumulación", "description": { "content": "Acumulación por datos de la venta.", "type": "text/plain" }, "item": [ { "id": "03ded708-cac8-4911-b56a-a7abeff8e24d", "name": "public Accumulate", "request": { "name": "public Accumulate", "description": { "content": "Public accumulation by sale facts\n\nSettles accumulation from sale facts (emit-by-rule). Tenancy comes from AuthContext.\nRequired body fields: member_ref, operation_key, external_ref, source, user_origin.\nHTTP 200 is success even when points=0 (RN-M11); see outcome.motivo_no_entrega.\nErrors use application/problem+json with HU-V2-16 families (validation, auth, conflict, business).", "type": "text/plain" }, "url": { "path": [ "v1", "loyalty", "public", "accumulations" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "api_version", "value": "", "description": "Versión de la API. Úsala si no envías el header X-API-Version. Si van los dos, manda el header." } ], "variable": [] }, "header": [ { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "" }, { "disabled": false, "description": "Comercio de la operación, cuando la credencial cubre más de uno.", "key": "X-Declared-Commerce-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"member_ref\": \"\",\n \"operation_key\": \"\",\n \"external_ref\": \"\",\n \"source\": \"\",\n \"user_origin\": \"\",\n \"gross_amount\": \"\",\n \"tax_amount\": \"\",\n \"shipping_amount\": \"\",\n \"category_code\": \"\",\n \"branch_id\": \"\",\n \"occurred_at\": \"\",\n \"expiry_date\": \"\",\n \"equivalence_value\": \"\",\n \"items\": [\n {\n \"line_id\": \"\",\n \"product_code\": \"\",\n \"quantity\": \"\",\n \"line_gross_amount\": \"\",\n \"unit_price\": \"\",\n \"unit_tax\": \"\",\n \"category_code\": \"\",\n \"description\": \"\"\n },\n {\n \"line_id\": \"\",\n \"product_code\": \"\",\n \"quantity\": \"\",\n \"line_gross_amount\": \"\",\n \"unit_price\": \"\",\n \"unit_tax\": \"\",\n \"category_code\": \"\",\n \"description\": \"\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "ea3a5701-93b0-424f-ac63-18e285250194", "name": "Settled or idempotent replay (including zero-points success)", "originalRequest": { "url": { "path": [ "v1", "loyalty", "public", "accumulations" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_version", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "1" }, { "disabled": false, "description": "Comercio de la operación, cuando la credencial cubre más de uno.", "key": "X-Declared-Commerce-Id", "value": "630" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"member_ref\": \"member-demo-001\",\n \"operation_key\": \"accum-demo-001\",\n \"external_ref\": \"ticket-1001\",\n \"source\": \"pos\",\n \"user_origin\": \"pos\",\n \"gross_amount\": 50000,\n \"category_code\": \"GROCERY\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"operation_key\": \"accum-demo-001\",\n \"commerce_id\": 630,\n \"member_ref\": \"member-demo-001\",\n \"points\": 50,\n \"rule_id\": \"rule-default\",\n \"entry_id\": \"22222222-2222-2222-2222-222222222222\",\n \"created_at\": \"2026-09-28T15:01:00Z\",\n \"lots\": [\n {\n \"lot_id\": \"33333333-3333-3333-3333-333333333333\",\n \"amount\": 50,\n \"expiry_date\": \"2027-09-28\",\n \"status\": \"active\"\n }\n ],\n \"outcome\": {\n \"multiplier\": {\n \"applied\": false\n },\n \"ceiling_applied\": false\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "116819e0-e796-47f6-a3fb-2d4bdcd9b29e", "name": "Validation / bad request (family validation — HU-V2-16)", "originalRequest": { "url": { "path": [ "v1", "loyalty", "public", "accumulations" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_version", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "1" }, { "disabled": false, "description": "Comercio de la operación, cuando la credencial cubre más de uno.", "key": "X-Declared-Commerce-Id", "value": "630" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"member_ref\": \"member-demo-001\",\n \"operation_key\": \"accum-demo-001\",\n \"external_ref\": \"ticket-1001\",\n \"source\": \"pos\",\n \"user_origin\": \"pos\",\n \"gross_amount\": 50000,\n \"category_code\": \"GROCERY\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"status\": 400,\n \"title\": \"Validation error\",\n \"detail\": \"member_ref is required\",\n \"code\": \"VALIDATION_ERROR\",\n \"family\": \"validation\",\n \"retryable\": false,\n \"catalog_version\": 1\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "aff86242-6121-4aea-8fcb-0b5eb3418273", "name": "Invalid or missing credential (family auth)", "originalRequest": { "url": { "path": [ "v1", "loyalty", "public", "accumulations" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_version", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "1" }, { "disabled": false, "description": "Comercio de la operación, cuando la credencial cubre más de uno.", "key": "X-Declared-Commerce-Id", "value": "630" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"member_ref\": \"member-demo-001\",\n \"operation_key\": \"accum-demo-001\",\n \"external_ref\": \"ticket-1001\",\n \"source\": \"pos\",\n \"user_origin\": \"pos\",\n \"gross_amount\": 50000,\n \"category_code\": \"GROCERY\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"status\": 9140,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"code\": \"string\",\n \"retryable\": true,\n \"family\": \"string\",\n \"catalog_version\": 8295,\n \"retry_after\": 9764\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4eef7349-8c1d-4075-9335-08ea6c74aac3", "name": "Tenant mismatch / not authorized (family auth)", "originalRequest": { "url": { "path": [ "v1", "loyalty", "public", "accumulations" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_version", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "1" }, { "disabled": false, "description": "Comercio de la operación, cuando la credencial cubre más de uno.", "key": "X-Declared-Commerce-Id", "value": "630" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"member_ref\": \"member-demo-001\",\n \"operation_key\": \"accum-demo-001\",\n \"external_ref\": \"ticket-1001\",\n \"source\": \"pos\",\n \"user_origin\": \"pos\",\n \"gross_amount\": 50000,\n \"category_code\": \"GROCERY\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"status\": 9140,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"code\": \"string\",\n \"retryable\": true,\n \"family\": \"string\",\n \"catalog_version\": 8295,\n \"retry_after\": 9764\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5057f701-d199-4355-aebd-80880b534d21", "name": "Idempotency fingerprint conflict (family conflict)", "originalRequest": { "url": { "path": [ "v1", "loyalty", "public", "accumulations" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_version", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "1" }, { "disabled": false, "description": "Comercio de la operación, cuando la credencial cubre más de uno.", "key": "X-Declared-Commerce-Id", "value": "630" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"member_ref\": \"member-demo-001\",\n \"operation_key\": \"accum-demo-001\",\n \"external_ref\": \"ticket-1001\",\n \"source\": \"pos\",\n \"user_origin\": \"pos\",\n \"gross_amount\": 50000,\n \"category_code\": \"GROCERY\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"status\": 9140,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"code\": \"string\",\n \"retryable\": true,\n \"family\": \"string\",\n \"catalog_version\": 8295,\n \"retry_after\": 9764\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "affcdc48-60a6-4911-9837-3b4707d663ba", "name": "Business state (paused program, not migrated, …)", "originalRequest": { "url": { "path": [ "v1", "loyalty", "public", "accumulations" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_version", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "1" }, { "disabled": false, "description": "Comercio de la operación, cuando la credencial cubre más de uno.", "key": "X-Declared-Commerce-Id", "value": "630" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"member_ref\": \"member-demo-001\",\n \"operation_key\": \"accum-demo-001\",\n \"external_ref\": \"ticket-1001\",\n \"source\": \"pos\",\n \"user_origin\": \"pos\",\n \"gross_amount\": 50000,\n \"category_code\": \"GROCERY\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"status\": 9140,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"code\": \"string\",\n \"retryable\": true,\n \"family\": \"string\",\n \"catalog_version\": 8295,\n \"retry_after\": 9764\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "001e7dcc-5221-49af-b2bd-652bdfd2deea", "name": "Premios", "description": { "content": "Premios del comercio.", "type": "text/plain" }, "item": [ { "id": "c65b178c-b0e3-44da-b73c-b863acaeec47", "name": "listar Premios Comercio", "request": { "name": "listar Premios Comercio", "description": { "content": "Lista los premios del comercio\n\nDevuelve los premios del comercio. El `reward_id` de la redención es el id de esta lista.", "type": "text/plain" }, "url": { "path": [ "v2", "loyalty", "commerce", ":id_commerce", "rewards" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "country_code", "value": "" }, { "disabled": false, "key": "page", "value": "" }, { "disabled": false, "key": "items", "value": "" }, { "disabled": false, "key": "word", "value": "" }, { "disabled": false, "key": "is_active", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "{{commerceId}}", "key": "id_commerce", "description": "(Required) " } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET" }, "response": [ { "id": "ba299fff-2c0a-4087-86ca-64f7b4230685", "name": "Premios del comercio", "originalRequest": { "url": { "path": [ "v2", "loyalty", "commerce", ":id_commerce", "rewards" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "country_code", "value": "" }, { "key": "page", "value": "" }, { "key": "items", "value": "" }, { "key": "word", "value": "" }, { "key": "is_active", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id_commerce", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"string\",\n \"data\": [\n {\n \"id_reward\": 226,\n \"name\": \"string\",\n \"description\": \"string\",\n \"code\": \"string\",\n \"required_points\": 1164,\n \"price\": 3670.596921483507,\n \"is_active\": true\n },\n {\n \"id_reward\": 2230,\n \"name\": \"string\",\n \"description\": \"string\",\n \"code\": \"string\",\n \"required_points\": 6172,\n \"price\": 7028.337107705344,\n \"is_active\": false\n }\n ],\n \"pagination\": {}\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a1339b82-5eb9-4aed-a1f3-9c90c27e8901", "name": "El comercio no tiene premios", "originalRequest": { "url": { "path": [ "v2", "loyalty", "commerce", ":id_commerce", "rewards" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "country_code", "value": "" }, { "key": "page", "value": "" }, { "key": "items", "value": "" }, { "key": "word", "value": "" }, { "key": "is_active", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "id_commerce", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "GET", "body": {} }, "status": "No Content", "code": 204, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "f2dafed3-9c40-4ded-a111-872c82369b70", "name": "Redención", "description": { "content": "Redención de un premio del comercio.", "type": "text/plain" }, "item": [ { "id": "6d1aaf71-c94c-44bf-a2f9-3853a6ae4af9", "name": "public Redeem", "request": { "name": "public Redeem", "description": { "content": "Public catalog redemption\n\nRedeems a catalog reward for the authenticated commerce tenant.\nRequired body: member_ref, reward_id, operation_key, external_ref, source.", "type": "text/plain" }, "url": { "path": [ "v1", "loyalty", "public", "redemptions" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "api_version", "value": "", "description": "Versión de la API. Úsala si no envías el header X-API-Version. Si van los dos, manda el header." } ], "variable": [] }, "header": [ { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "" }, { "disabled": false, "description": "Comercio de la operación, cuando la credencial cubre más de uno.", "key": "X-Declared-Commerce-Id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"member_ref\": \"\",\n \"reward_id\": \"\",\n \"operation_key\": \"\",\n \"external_ref\": \"\",\n \"source\": \"\",\n \"branch_id\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "d52e4bc4-9053-42ce-b1e3-994fc867ee3c", "name": "Redeemed or idempotent replay", "originalRequest": { "url": { "path": [ "v1", "loyalty", "public", "redemptions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_version", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "1" }, { "disabled": false, "description": "Comercio de la operación, cuando la credencial cubre más de uno.", "key": "X-Declared-Commerce-Id", "value": "630" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"member_ref\": \"member-demo-001\",\n \"reward_id\": \"reward-coffee\",\n \"operation_key\": \"redeem-demo-001\",\n \"external_ref\": \"ticket-2001\",\n \"source\": \"pos\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"entry_id\": \"55555555-5555-5555-5555-555555555555\",\n \"transaction_type\": \"redeem\",\n \"commerce_id\": 630,\n \"member_ref\": \"member-demo-001\",\n \"amount\": 100,\n \"active_balance_after\": 20,\n \"lot_allocations\": [\n {\n \"lot_id\": \"33333333-3333-3333-3333-333333333333\",\n \"amount\": 100\n }\n ],\n \"operation_key\": \"redeem-demo-001\",\n \"created_at\": \"2026-09-28T15:03:00Z\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "55321a36-5d0c-43b4-8c6b-5c4d02752f91", "name": "Validation / bad request (family validation)", "originalRequest": { "url": { "path": [ "v1", "loyalty", "public", "redemptions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_version", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "1" }, { "disabled": false, "description": "Comercio de la operación, cuando la credencial cubre más de uno.", "key": "X-Declared-Commerce-Id", "value": "630" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"member_ref\": \"member-demo-001\",\n \"reward_id\": \"reward-coffee\",\n \"operation_key\": \"redeem-demo-001\",\n \"external_ref\": \"ticket-2001\",\n \"source\": \"pos\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"status\": 9140,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"code\": \"string\",\n \"retryable\": true,\n \"family\": \"string\",\n \"catalog_version\": 8295,\n \"retry_after\": 9764\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5905c062-e101-4ab8-8f3c-3e9f9a384688", "name": "Invalid or missing credential (family auth)", "originalRequest": { "url": { "path": [ "v1", "loyalty", "public", "redemptions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_version", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "1" }, { "disabled": false, "description": "Comercio de la operación, cuando la credencial cubre más de uno.", "key": "X-Declared-Commerce-Id", "value": "630" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"member_ref\": \"member-demo-001\",\n \"reward_id\": \"reward-coffee\",\n \"operation_key\": \"redeem-demo-001\",\n \"external_ref\": \"ticket-2001\",\n \"source\": \"pos\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"status\": 9140,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"code\": \"string\",\n \"retryable\": true,\n \"family\": \"string\",\n \"catalog_version\": 8295,\n \"retry_after\": 9764\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b7f95149-bfce-4b2b-af5f-44c46b294e9c", "name": "Tenant mismatch / not authorized (family auth)", "originalRequest": { "url": { "path": [ "v1", "loyalty", "public", "redemptions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_version", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "1" }, { "disabled": false, "description": "Comercio de la operación, cuando la credencial cubre más de uno.", "key": "X-Declared-Commerce-Id", "value": "630" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"member_ref\": \"member-demo-001\",\n \"reward_id\": \"reward-coffee\",\n \"operation_key\": \"redeem-demo-001\",\n \"external_ref\": \"ticket-2001\",\n \"source\": \"pos\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Forbidden", "code": 403, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"status\": 9140,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"code\": \"string\",\n \"retryable\": true,\n \"family\": \"string\",\n \"catalog_version\": 8295,\n \"retry_after\": 9764\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e7511e22-56b6-4fba-9389-05d8a0197846", "name": "Idempotency fingerprint conflict (family conflict)", "originalRequest": { "url": { "path": [ "v1", "loyalty", "public", "redemptions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_version", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "1" }, { "disabled": false, "description": "Comercio de la operación, cuando la credencial cubre más de uno.", "key": "X-Declared-Commerce-Id", "value": "630" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"member_ref\": \"member-demo-001\",\n \"reward_id\": \"reward-coffee\",\n \"operation_key\": \"redeem-demo-001\",\n \"external_ref\": \"ticket-2001\",\n \"source\": \"pos\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"status\": 9140,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"code\": \"string\",\n \"retryable\": true,\n \"family\": \"string\",\n \"catalog_version\": 8295,\n \"retry_after\": 9764\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9e3b2cec-3095-4dd6-8de7-355cf487decd", "name": "Business state / insufficient balance / archived program", "originalRequest": { "url": { "path": [ "v1", "loyalty", "public", "redemptions" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "api_version", "value": "1" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "disabled": false, "description": "Versión de la API. Envía 1.", "key": "X-API-Version", "value": "1" }, { "disabled": false, "description": "Comercio de la operación, cuando la credencial cubre más de uno.", "key": "X-Declared-Commerce-Id", "value": "630" }, { "key": "Accept", "value": "application/problem+json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"member_ref\": \"member-demo-001\",\n \"reward_id\": \"reward-coffee\",\n \"operation_key\": \"redeem-demo-001\",\n \"external_ref\": \"ticket-2001\",\n \"source\": \"pos\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/problem+json" } ], "body": "{\n \"status\": 9140,\n \"title\": \"string\",\n \"detail\": \"string\",\n \"code\": \"string\",\n \"retryable\": true,\n \"family\": \"string\",\n \"catalog_version\": 8295,\n \"retry_after\": 9764\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "8b7b7d1e-7229-43f4-9ba4-87d76c1d10df", "name": "Anulación", "description": { "content": "Anulación de una acumulación o de una redención.", "type": "text/plain" }, "item": [ { "id": "937f88a6-7a90-4a13-b6b9-b2483b0059aa", "name": "reverse Emission", "request": { "name": "reverse Emission", "description": { "content": "Reverse an emission", "type": "text/plain" }, "url": { "path": [ "v1", "loyalty", "api", "points", "ledger", "emissions", "reversals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{sigv4}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"commerce_id\": \"\",\n \"member_ref\": \"\",\n \"operation_key\": \"\",\n \"origin_operation_key\": \"\",\n \"origin_entry_id\": \"\",\n \"external_ref\": \"\",\n \"source\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "5d0cf80f-1c10-4251-936b-459ae2821b2f", "name": "Idempotent replay of a prior acceptance", "originalRequest": { "url": { "path": [ "v1", "loyalty", "api", "points", "ledger", "emissions", "reversals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"commerce_id\": 630,\n \"member_ref\": \"\",\n \"operation_key\": \"pos-ticket-778-reverse\",\n \"origin_operation_key\": \"\",\n \"origin_entry_id\": \"\",\n \"external_ref\": \"\",\n \"source\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"key_0\": 3794.6838482931544\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3c38b5c5-fe67-497b-a230-3acf2dd90172", "name": "Accepted (first write)", "originalRequest": { "url": { "path": [ "v1", "loyalty", "api", "points", "ledger", "emissions", "reversals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"commerce_id\": 630,\n \"member_ref\": \"\",\n \"operation_key\": \"pos-ticket-778-reverse\",\n \"origin_operation_key\": \"\",\n \"origin_entry_id\": \"\",\n \"external_ref\": \"\",\n \"source\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"key_0\": 3794.6838482931544\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "216ba10e-2e39-4565-9ed4-c42d92ab2185", "name": "Malformed JSON / unexpected error mapping", "originalRequest": { "url": { "path": [ "v1", "loyalty", "api", "points", "ledger", "emissions", "reversals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"commerce_id\": 630,\n \"member_ref\": \"\",\n \"operation_key\": \"pos-ticket-778-reverse\",\n \"origin_operation_key\": \"\",\n \"origin_entry_id\": \"\",\n \"external_ref\": \"\",\n \"source\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ffc0afe2-3bc2-4154-a0bb-8d9dd863292d", "name": "Origin not found or lot not reversible (`ORIGEN_NO_LOCALIZABLE`, `LOTE_NO_REVERSIBLE`)", "originalRequest": { "url": { "path": [ "v1", "loyalty", "api", "points", "ledger", "emissions", "reversals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"commerce_id\": 630,\n \"member_ref\": \"\",\n \"operation_key\": \"pos-ticket-778-reverse\",\n \"origin_operation_key\": \"\",\n \"origin_entry_id\": \"\",\n \"external_ref\": \"\",\n \"source\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9247f308-ef80-4599-937a-49a994604a7c", "name": "Already reversed or ambiguous external_ref (`REVERSA_YA_APLICADA`, `EXTERNAL_REF_AMBIGUOUS`)", "originalRequest": { "url": { "path": [ "v1", "loyalty", "api", "points", "ledger", "emissions", "reversals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"commerce_id\": 630,\n \"member_ref\": \"\",\n \"operation_key\": \"pos-ticket-778-reverse\",\n \"origin_operation_key\": \"\",\n \"origin_entry_id\": \"\",\n \"external_ref\": \"\",\n \"source\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9ecbec5b-2617-446f-9b00-1add0403b7c7", "name": "Validation (missing member_ref / operation_key / origin locator)", "originalRequest": { "url": { "path": [ "v1", "loyalty", "api", "points", "ledger", "emissions", "reversals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"commerce_id\": 630,\n \"member_ref\": \"\",\n \"operation_key\": \"pos-ticket-778-reverse\",\n \"origin_operation_key\": \"\",\n \"origin_entry_id\": \"\",\n \"external_ref\": \"\",\n \"source\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "4bcb72a6-fee1-4b0d-a8be-cb2524537efb", "name": "reverse Redemption", "request": { "name": "reverse Redemption", "description": { "content": "Reverse a redemption", "type": "text/plain" }, "url": { "path": [ "v1", "loyalty", "api", "points", "ledger", "redemptions", "reversals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "Authorization", "type": "string" }, { "key": "value", "value": "{{sigv4}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"commerce_id\": \"\",\n \"member_ref\": \"\",\n \"operation_key\": \"\",\n \"motive\": \"\",\n \"origin_operation_key\": \"\",\n \"origin_entry_id\": \"\",\n \"external_ref\": \"\",\n \"source\": \"\",\n \"motive_text\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "4352f6b1-e69d-45c4-8c08-1919f6383c5d", "name": "Idempotent replay of a prior acceptance", "originalRequest": { "url": { "path": [ "v1", "loyalty", "api", "points", "ledger", "redemptions", "reversals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"commerce_id\": 630,\n \"member_ref\": \"\",\n \"operation_key\": \"pos-ticket-778-redeem-reverse\",\n \"motive\": \"\",\n \"origin_operation_key\": \"\",\n \"origin_entry_id\": \"\",\n \"external_ref\": \"\",\n \"source\": \"\",\n \"motive_text\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"key_0\": 3794.6838482931544\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e2b25762-02f0-454b-9922-4a3f5b8566d3", "name": "Accepted (first write)", "originalRequest": { "url": { "path": [ "v1", "loyalty", "api", "points", "ledger", "redemptions", "reversals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"commerce_id\": 630,\n \"member_ref\": \"\",\n \"operation_key\": \"pos-ticket-778-redeem-reverse\",\n \"motive\": \"\",\n \"origin_operation_key\": \"\",\n \"origin_entry_id\": \"\",\n \"external_ref\": \"\",\n \"source\": \"\",\n \"motive_text\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"key_0\": 3794.6838482931544\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "40c64cac-5683-4f87-8403-41bf5c5fcbbd", "name": "Malformed JSON / unexpected error mapping", "originalRequest": { "url": { "path": [ "v1", "loyalty", "api", "points", "ledger", "redemptions", "reversals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"commerce_id\": 630,\n \"member_ref\": \"\",\n \"operation_key\": \"pos-ticket-778-redeem-reverse\",\n \"motive\": \"\",\n \"origin_operation_key\": \"\",\n \"origin_entry_id\": \"\",\n \"external_ref\": \"\",\n \"source\": \"\",\n \"motive_text\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "156fa0ee-38b8-4593-a699-d7fa8bb94267", "name": "Origin not found or lot not reversible", "originalRequest": { "url": { "path": [ "v1", "loyalty", "api", "points", "ledger", "redemptions", "reversals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"commerce_id\": 630,\n \"member_ref\": \"\",\n \"operation_key\": \"pos-ticket-778-redeem-reverse\",\n \"motive\": \"\",\n \"origin_operation_key\": \"\",\n \"origin_entry_id\": \"\",\n \"external_ref\": \"\",\n \"source\": \"\",\n \"motive_text\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7b0e64ea-fd8a-40d4-abe4-558bfda97076", "name": "Already reversed or ambiguous external_ref", "originalRequest": { "url": { "path": [ "v1", "loyalty", "api", "points", "ledger", "redemptions", "reversals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"commerce_id\": 630,\n \"member_ref\": \"\",\n \"operation_key\": \"pos-ticket-778-redeem-reverse\",\n \"motive\": \"\",\n \"origin_operation_key\": \"\",\n \"origin_entry_id\": \"\",\n \"external_ref\": \"\",\n \"source\": \"\",\n \"motive_text\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Conflict", "code": 409, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d7bbb8d9-bbe6-4146-a0a2-73f539fb7dab", "name": "Validation (missing member_ref, motive, or origin locator)", "originalRequest": { "url": { "path": [ "v1", "loyalty", "api", "points", "ledger", "redemptions", "reversals" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "Authorization", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"commerce_id\": 630,\n \"member_ref\": \"\",\n \"operation_key\": \"pos-ticket-778-redeem-reverse\",\n \"motive\": \"\",\n \"origin_operation_key\": \"\",\n \"origin_entry_id\": \"\",\n \"external_ref\": \"\",\n \"source\": \"\",\n \"motive_text\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"error\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "39d5cc66-ccfa-48f9-bab8-0433fb9a8e7c", "name": "OTP", "description": { "content": "Generar y validar el OTP.", "type": "text/plain" }, "item": [ { "id": "5d63e964-8e9b-4a6d-b762-a8c5da48f8b4", "name": "Generar OTP\n\nGenera un código OTP y lo envía al usuario por el canal configurado (email, SMS, WhatsApp)", "request": { "name": "Generar OTP\n\nGenera un código OTP y lo envía al usuario por el canal configurado (email, SMS, WhatsApp)", "description": { "content": "Generar OTP\n\nGenera un código OTP y lo envía al usuario por el canal configurado (email, SMS, WhatsApp)", "type": "text/plain" }, "url": { "path": [ "v2", "otp", "otp", "generate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"cellphone\": \"\",\n \"commerceId\": \"\",\n \"countryCode\": \"\",\n \"email\": \"\",\n \"flow\": \"\",\n \"uid\": \"\",\n \"usecaseId\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "afc2c2ca-c7a5-4e49-8b74-33e81ef50ca7", "name": "OTP generado exitosamente", "originalRequest": { "url": { "path": [ "v2", "otp", "otp", "generate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"cellphone\": \"\",\n \"commerceId\": \"\",\n \"countryCode\": \"\",\n \"email\": \"\",\n \"flow\": \"\",\n \"uid\": \"\",\n \"usecaseId\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"currentValidationChannel\": \"string\",\n \"nextValidationChannel\": \"string\",\n \"options\": [\n \"string\",\n \"string\"\n ],\n \"otpId\": 1107\n },\n \"metadata\": \"\",\n \"success\": false,\n \"timestamp\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "019fe178-461b-47d6-85d8-5d2927923f94", "name": "Error en la solicitud", "originalRequest": { "url": { "path": [ "v2", "otp", "otp", "generate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"cellphone\": \"\",\n \"commerceId\": \"\",\n \"countryCode\": \"\",\n \"email\": \"\",\n \"flow\": \"\",\n \"uid\": \"\",\n \"usecaseId\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n \"string\",\n \"string\"\n ],\n \"metadata\": \"\",\n \"success\": true,\n \"timestamp\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "41853085-c140-45fc-bea0-9c2ee1111f90", "name": "Error de validación", "originalRequest": { "url": { "path": [ "v2", "otp", "otp", "generate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"cellphone\": \"\",\n \"commerceId\": \"\",\n \"countryCode\": \"\",\n \"email\": \"\",\n \"flow\": \"\",\n \"uid\": \"\",\n \"usecaseId\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n \"string\",\n \"string\"\n ],\n \"metadata\": \"\",\n \"success\": false,\n \"timestamp\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4771679c-17f2-4d21-925b-41d229c2bac1", "name": "Error interno del servidor", "originalRequest": { "url": { "path": [ "v2", "otp", "otp", "generate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"cellphone\": \"\",\n \"commerceId\": \"\",\n \"countryCode\": \"\",\n \"email\": \"\",\n \"flow\": \"\",\n \"uid\": \"\",\n \"usecaseId\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n \"string\",\n \"string\"\n ],\n \"metadata\": \"\",\n \"success\": false,\n \"timestamp\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "bcc01247-56bd-40f3-8cea-0fb729f21f8f", "name": "Validar OTP\n\nValida un código OTP proporcionado por el usuario", "request": { "name": "Validar OTP\n\nValida un código OTP proporcionado por el usuario", "description": { "content": "Validar OTP\n\nValida un código OTP proporcionado por el usuario", "type": "text/plain" }, "url": { "path": [ "v2", "otp", "otp", "validate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"otpCode\": \"\",\n \"otpId\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "a9db2d5d-fb36-4d21-96b3-97c9eef22305", "name": "Validación exitosa", "originalRequest": { "url": { "path": [ "v2", "otp", "otp", "validate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"otpCode\": \"\",\n \"otpId\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"isValid\": true,\n \"otpId\": 5562\n },\n \"metadata\": \"\",\n \"success\": true,\n \"timestamp\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3fe9de40-440e-46a2-a8a9-bb2c7d849c67", "name": "Error en la validación", "originalRequest": { "url": { "path": [ "v2", "otp", "otp", "validate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"otpCode\": \"\",\n \"otpId\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n \"string\",\n \"string\"\n ],\n \"metadata\": \"\",\n \"success\": false,\n \"timestamp\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "bdc2f50e-2c05-4a64-bf0f-5215e18dee39", "name": "Error de validación", "originalRequest": { "url": { "path": [ "v2", "otp", "otp", "validate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"otpCode\": \"\",\n \"otpId\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"errors\": [\n \"string\",\n \"string\"\n ],\n \"metadata\": \"\",\n \"success\": false,\n \"timestamp\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "1258fe8e-8885-4eaf-ac00-53b3fc1f370b", "name": "Perfil", "description": { "content": "Perfil de los clientes del comercio.", "type": "text/plain" }, "item": [ { "id": "92c58979-6ab1-477e-b4ea-db1f396943eb", "name": "Endpoint que permite obtener el total de clientes de un comercio", "request": { "name": "Endpoint que permite obtener el total de clientes de un comercio", "description": { "content": "Endpoint que permite obtener el total de clientes de un comercio", "type": "text/plain" }, "url": { "path": [ "v2", "crm", "api", "clients", ":commerceId", "info", "behavioral" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET" }, "response": [ { "id": "05f121fe-e745-4b61-ab6b-177d14024389", "name": "Successful", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "clients", ":commerceId", "info", "behavioral" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"totalClients\": 20\n },\n \"message\": \"Operation executed successfully\",\n \"statusCode\": 200\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3b5764ab-8641-433d-ba22-32b1e8a9e479", "name": "Bad request", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "clients", ":commerceId", "info", "behavioral" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 400,\n \"message\": \"Bad request\",\n \"error\": \"Invalid request\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "986ad79a-4058-45eb-a206-12c306f11ff9", "name": "UnAuthorized", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "clients", ":commerceId", "info", "behavioral" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 401,\n \"message\": \"Unauthorized\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "ea33c5e4-99c2-4164-bfac-5e1aa67e8f61", "name": "Endpoint que permite consultar los géneros y los grupos de edades por comercio", "request": { "name": "Endpoint que permite consultar los géneros y los grupos de edades por comercio", "description": { "content": "Endpoint que permite consultar los géneros y los grupos de edades por comercio", "type": "text/plain" }, "url": { "path": [ "v2", "crm", "api", "clients", "commerce", ":commerceId", "info", "demographic" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "branchId", "value": "", "description": "ID de la sucursal (opcional)." } ], "variable": [ { "disabled": false, "type": "any", "value": "{{commerceId}}", "key": "commerceId", "description": "(Required) ID del comercio" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET" }, "response": [ { "id": "93f42fde-fc20-41ea-96c4-7f117ffa8965", "name": "Successful", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "clients", "commerce", ":commerceId", "info", "demographic" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "branchId", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerceId", "description": "(Required) ID del comercio" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 5156,\n \"message\": \"string\",\n \"data\": {\n \"genders\": [\n {\n \"id\": \"1\",\n \"name\": \"Male\",\n \"total\": 100,\n \"percentage\": \"50%\"\n },\n {\n \"id\": \"1\",\n \"name\": \"Male\",\n \"total\": 100,\n \"percentage\": \"50%\"\n }\n ],\n \"ages\": [\n {\n \"id\": \"1\",\n \"name\": \"18-25\",\n \"total\": 50,\n \"percentage\": \"25%\"\n },\n {\n \"id\": \"1\",\n \"name\": \"18-25\",\n \"total\": 50,\n \"percentage\": \"25%\"\n }\n ]\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4c649e89-7a19-48a6-9f6d-95a55fbba6f4", "name": "Bad request", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "clients", "commerce", ":commerceId", "info", "demographic" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "branchId", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerceId", "description": "(Required) ID del comercio" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 400,\n \"message\": \"Bad request\",\n \"error\": \"Invalid request\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "a8b0e5ff-5d07-4621-af95-f5ceef6511f3", "name": "UnAuthorized", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "clients", "commerce", ":commerceId", "info", "demographic" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "branchId", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerceId", "description": "(Required) ID del comercio" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 401,\n \"message\": \"Unauthorized\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "2fc7616e-fa7a-432d-b819-321bdd8ad324", "name": "Endpoint que permite consultar las estadísticas RFM por comercio", "request": { "name": "Endpoint que permite consultar las estadísticas RFM por comercio", "description": { "content": "Endpoint que permite consultar las estadísticas RFM por comercio", "type": "text/plain" }, "url": { "path": [ "v2", "crm", "api", "clients", "rfm", ":commerceId" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "branchId", "value": "", "description": "ID de la sucursal (opcional)." } ], "variable": [ { "disabled": false, "type": "any", "value": "{{commerceId}}", "key": "commerceId", "description": "(Required) ID del comercio" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET" }, "response": [ { "id": "2146fe7b-2703-42a5-b7da-81eb466f95b7", "name": "Successful", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "clients", "rfm", ":commerceId" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "branchId", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerceId", "description": "(Required) ID del comercio" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 4003,\n \"message\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8b997a53-01f1-41a0-a635-dd1f35e903c0", "name": "Bad request", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "clients", "rfm", ":commerceId" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "branchId", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerceId", "description": "(Required) ID del comercio" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 400,\n \"message\": \"Bad request\",\n \"error\": \"Invalid request\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "86aff471-8bc3-4ab5-a297-739b73fa433d", "name": "UnAuthorized", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "clients", "rfm", ":commerceId" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "branchId", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerceId", "description": "(Required) ID del comercio" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 401,\n \"message\": \"Unauthorized\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d47f6322-c2be-4d5a-932f-ac83122d2a9c", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "clients", "rfm", ":commerceId" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "branchId", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerceId", "description": "(Required) ID del comercio" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 500,\n \"message\": \"Internal server error\",\n \"error\": \"Internal server error\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "8af9a094-448f-40dc-aaee-8b1c7b9a6e40", "name": "Endpoint que permite actualizar el estado de un cliente para un comercio", "request": { "name": "Endpoint que permite actualizar el estado de un cliente para un comercio", "description": { "content": "Endpoint que permite actualizar el estado de un cliente para un comercio", "type": "text/plain" }, "url": { "path": [ "v2", "crm", "api", "clients", "status", ":userId", ":commerceId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "{{commerceId}}", "key": "commerceId", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "userId", "description": "(Required) ID del usuario" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\",\n \"clientSearch\": \"\",\n \"sortField\": \"\",\n \"sortType\": \"\",\n \"createdAfter\": \"\",\n \"createdBefore\": \"\",\n \"pageSize\": \"\",\n \"currentPage\": \"\",\n \"idFranchise\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "fc87e0e5-7cc8-4c13-ac80-abdaf85e156f", "name": "Successful", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "clients", "status", ":userId", ":commerceId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerceId", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "userId", "description": "(Required) ID del usuario" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\",\n \"clientSearch\": \"\",\n \"sortField\": \"\",\n \"sortType\": \"\",\n \"createdAfter\": \"\",\n \"createdBefore\": \"\",\n \"pageSize\": \"\",\n \"currentPage\": \"\",\n \"idFranchise\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 200,\n \"message\": \"Operation executed successfully\",\n \"data\": \"response\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "1623440e-3c9f-4d22-bbb3-ed686509227f", "name": "Bad request", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "clients", "status", ":userId", ":commerceId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerceId", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "userId", "description": "(Required) ID del usuario" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\",\n \"clientSearch\": \"\",\n \"sortField\": \"\",\n \"sortType\": \"\",\n \"createdAfter\": \"\",\n \"createdBefore\": \"\",\n \"pageSize\": \"\",\n \"currentPage\": \"\",\n \"idFranchise\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 400,\n \"message\": \"Bad request\",\n \"error\": \"Invalid request\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "d461826c-8cf0-44ed-b23d-6e148e7d85ee", "name": "UnAuthorized", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "clients", "status", ":userId", ":commerceId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerceId", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "userId", "description": "(Required) ID del usuario" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\",\n \"clientSearch\": \"\",\n \"sortField\": \"\",\n \"sortType\": \"\",\n \"createdAfter\": \"\",\n \"createdBefore\": \"\",\n \"pageSize\": \"\",\n \"currentPage\": \"\",\n \"idFranchise\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 401,\n \"message\": \"Unauthorized\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6d6166a4-b00f-4ab6-a8bb-f561e984b057", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "clients", "status", ":userId", ":commerceId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerceId", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "userId", "description": "(Required) ID del usuario" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"status\": \"\",\n \"clientSearch\": \"\",\n \"sortField\": \"\",\n \"sortType\": \"\",\n \"createdAfter\": \"\",\n \"createdBefore\": \"\",\n \"pageSize\": \"\",\n \"currentPage\": \"\",\n \"idFranchise\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 500,\n \"message\": \"Internal server error\",\n \"error\": \"Internal server error\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "eb303fc1-af96-444c-af12-ff7ceb52dc63", "name": "Endpoint que permite obtener listado de clientes de un comercio", "request": { "name": "Endpoint que permite obtener listado de clientes de un comercio", "description": { "content": "Endpoint que permite obtener listado de clientes de un comercio", "type": "text/plain" }, "url": { "path": [ "v2", "crm", "api", "clients", ":commerceId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "{{commerceId}}", "key": "commerceId", "description": "(Required) ID del comercio" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"clientSearch\": \"\",\n \"sortField\": \"\",\n \"sortType\": \"\",\n \"createdAfter\": \"\",\n \"createdBefore\": \"\",\n \"pageSize\": \"\",\n \"currentPage\": \"\",\n \"idFranchise\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "d9deefb8-d4ab-4194-85a7-6262a2a7d0db", "name": "Successful", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "clients", ":commerceId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerceId", "description": "(Required) ID del comercio" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"currentPage\": 1,\n \"pageSize\": 20,\n \"sortType\": \"desc\",\n \"sortField\": \"lifeTimeValue\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": [\n {\n \"name\": \"Alberto Urueta\",\n \"ageGroup\": \"25-34\",\n \"age\": 33,\n \"gender\": \"male\",\n \"statusRFM\": \"Leal\",\n \"averageTicket\": 17091862.652777776,\n \"lifeTimeValue\": 1230614111,\n \"lastRating\": 8,\n \"numberOfVisits\": 111,\n \"lastVisit\": \"2019-06-06T00:00:00+00:00\",\n \"pointsAvailable\": -5,\n \"usedPoints\": 6014,\n \"expiredPoints\": 1225159,\n \"status\": \"activa\",\n \"birthday\": \"1991-12-18T00:00:00+00:00\",\n \"email\": \"cenarius12@gmail.com\",\n \"phone\": \"3002575486\",\n \"documentNumber\": \"1143356182\",\n \"firstName\": \"Alberto\",\n \"lastName\": \"Urueta\",\n \"documentType\": \"Cédula Ciudadanía\",\n \"location\": \"\"\n }\n ],\n \"message\": \"Operation executed successfully\",\n \"pagination\": {\n \"currentPage\": 1,\n \"hasNextPage\": true,\n \"hasPreviousPage\": false,\n \"pageSize\": 20\n },\n \"statusCode\": 200\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "8a0b6805-4559-46e1-88c3-4f80db6038c7", "name": "Bad request", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "clients", ":commerceId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerceId", "description": "(Required) ID del comercio" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"currentPage\": 1,\n \"pageSize\": 20,\n \"sortType\": \"desc\",\n \"sortField\": \"lifeTimeValue\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 400,\n \"message\": \"Bad request\",\n \"error\": \"Invalid request\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3c878011-a92a-4932-bac7-22a06e7f18e0", "name": "UnAuthorized", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "clients", ":commerceId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerceId", "description": "(Required) ID del comercio" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"currentPage\": 1,\n \"pageSize\": 20,\n \"sortType\": \"desc\",\n \"sortField\": \"lifeTimeValue\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 401,\n \"message\": \"Unauthorized\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "0595a867-eccb-4e72-ad41-06538aab7e09", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "clients", ":commerceId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerceId", "description": "(Required) ID del comercio" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"currentPage\": 1,\n \"pageSize\": 20,\n \"sortType\": \"desc\",\n \"sortField\": \"lifeTimeValue\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 500,\n \"message\": \"Internal server error\",\n \"error\": \"Internal server error\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "f08f0fe6-fb61-42ed-bb91-178ed6408767", "name": "Audiencias", "description": { "content": "Crear", "type": "text/plain" }, "item": [ { "id": "5c3a0209-97d4-446c-b0d3-44f0686bf210", "name": "Crea una nueva audiencia (V2) - Soporta audiencias legacy (applied_filters) y groups (condition tree)\n\nEste endpoint soporta **dos formatos** de cuerpo detectados automáticamente por la presencia de la clave `groups`:\n\n### Formato groups (condition tree builder)\nPersiste un segmento activo con árbol de condiciones (`condition_tree`) y filtros mapeados legacy (`filters[]`).\n- **Detección**: cuerpo contiene la clave `groups`\n- `type`: debe ser `static` o `dynamic` (requerido; `manual` no permitido)\n- `name`: requerido, trimmed antes de validación de unicidad (case-insensitive)\n- `groups[]`: árbol de condiciones; mínimo una hoja completa y mapenable\n- `member_count` siempre `0` en el 201 (eventual consistency via pipeline async)\n\n### Formato Legacy (V2 — applied_filters)\nComportamiento previo sin cambios:\n- **Detección**: cuerpo NO contiene la clave `groups`\n- `audience_type`: `dynamic`, `static` o `manual`\n- `filters_applied`: requerido para dynamic/static\n- `uids`: requerido para manual", "request": { "name": "Crea una nueva audiencia (V2) - Soporta audiencias legacy (applied_filters) y groups (condition tree)\n\nEste endpoint soporta **dos formatos** de cuerpo detectados automáticamente por la presencia de la clave `groups`:\n\n### Formato groups (condition tree builder)\nPersiste un segmento activo con árbol de condiciones (`condition_tree`) y filtros mapeados legacy (`filters[]`).\n- **Detección**: cuerpo contiene la clave `groups`\n- `type`: debe ser `static` o `dynamic` (requerido; `manual` no permitido)\n- `name`: requerido, trimmed antes de validación de unicidad (case-insensitive)\n- `groups[]`: árbol de condiciones; mínimo una hoja completa y mapenable\n- `member_count` siempre `0` en el 201 (eventual consistency via pipeline async)\n\n### Formato Legacy (V2 — applied_filters)\nComportamiento previo sin cambios:\n- **Detección**: cuerpo NO contiene la clave `groups`\n- `audience_type`: `dynamic`, `static` o `manual`\n- `filters_applied`: requerido para dynamic/static\n- `uids`: requerido para manual", "description": { "content": "Crea una nueva audiencia (V2) - Soporta audiencias legacy (applied_filters) y groups (condition tree)\n\nEste endpoint soporta **dos formatos** de cuerpo detectados automáticamente por la presencia de la clave `groups`:\n\n### Formato groups (condition tree builder)\nPersiste un segmento activo con árbol de condiciones (`condition_tree`) y filtros mapeados legacy (`filters[]`).\n- **Detección**: cuerpo contiene la clave `groups`\n- `type`: debe ser `static` o `dynamic` (requerido; `manual` no permitido)\n- `name`: requerido, trimmed antes de validación de unicidad (case-insensitive)\n- `groups[]`: árbol de condiciones; mínimo una hoja completa y mapenable\n- `member_count` siempre `0` en el 201 (eventual consistency via pipeline async)\n\n### Formato Legacy (V2 — applied_filters)\nComportamiento previo sin cambios:\n- **Detección**: cuerpo NO contiene la clave `groups`\n- `audience_type`: `dynamic`, `static` o `manual`\n- `filters_applied`: requerido para dynamic/static\n- `uids`: requerido para manual", "type": "text/plain" }, "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "{{commerceId}}", "key": "commerce_id", "description": "(Required) ID del comercio" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"type\": \"\",\n \"groups\": [\n {\n \"operator\": \"\",\n \"conditions\": [\n {\n \"attributeId\": \"\",\n \"field\": \"\",\n \"operator\": \"\",\n \"dataType\": \"\",\n \"value\": {},\n \"subFilters\": [\n \"\",\n \"\"\n ]\n },\n {\n \"attributeId\": \"\",\n \"field\": \"\",\n \"operator\": \"\",\n \"dataType\": \"\",\n \"value\": {},\n \"subFilters\": [\n \"\",\n \"\"\n ]\n }\n ]\n },\n {\n \"operator\": \"\",\n \"conditions\": [\n {\n \"attributeId\": \"\",\n \"field\": \"\",\n \"operator\": \"\",\n \"dataType\": \"\",\n \"value\": {},\n \"subFilters\": [\n \"\",\n \"\"\n ]\n },\n {\n \"attributeId\": \"\",\n \"field\": \"\",\n \"operator\": \"\",\n \"dataType\": \"\",\n \"value\": {},\n \"subFilters\": [\n \"\",\n \"\"\n ]\n }\n ]\n }\n ],\n \"interGroupOperator\": \"and\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "f7570ef7-2bbe-48ef-a05c-77e189828e77", "name": "Audiencia creada con éxito", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"Clientes VIP\",\n \"type\": \"dynamic\",\n \"interGroupOperator\": \"and\",\n \"groups\": [\n {\n \"operator\": \"and\",\n \"conditions\": [\n {\n \"field\": \"age\",\n \"operator\": \"gt\",\n \"dataType\": \"numeric\",\n \"value\": 30\n }\n ]\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"segmentation_id\": \"664abc123def456\",\n \"status\": \"active\",\n \"created_at\": \"2026-07-07T13:00:00Z\",\n \"member_count\": 0\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "dee8e88d-00c1-4240-8c1e-ef25059f1fd8", "name": "Error de validación", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"Clientes VIP\",\n \"type\": \"dynamic\",\n \"interGroupOperator\": \"and\",\n \"groups\": [\n {\n \"operator\": \"and\",\n \"conditions\": [\n {\n \"field\": \"age\",\n \"operator\": \"gt\",\n \"dataType\": \"numeric\",\n \"value\": 30\n }\n ]\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"El campo 'type' es requerido\",\n \"data\": {\n \"code\": \"ErrMissingType\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4e3eff9e-5ef6-4d74-b827-c423601a8c2e", "name": "Filtro desconocido o usuario no pertenece al comercio (legacy)", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"Clientes VIP\",\n \"type\": \"dynamic\",\n \"interGroupOperator\": \"and\",\n \"groups\": [\n {\n \"operator\": \"and\",\n \"conditions\": [\n {\n \"field\": \"age\",\n \"operator\": \"gt\",\n \"dataType\": \"numeric\",\n \"value\": 30\n }\n ]\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"El filtro enviado es desconocido\",\n \"data\": {\n \"code\": \"UnknowFilter: city_id\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9b4b7515-a730-481d-aea4-723a4d2277ac", "name": "Error semántico — nombre duplicado o árbol incompleto (groups create)", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"Clientes VIP\",\n \"type\": \"dynamic\",\n \"interGroupOperator\": \"and\",\n \"groups\": [\n {\n \"operator\": \"and\",\n \"conditions\": [\n {\n \"field\": \"age\",\n \"operator\": \"gt\",\n \"dataType\": \"numeric\",\n \"value\": 30\n }\n ]\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"Ya existe un segmento con ese nombre para este comercio\",\n \"data\": {\n \"code\": \"ErrDuplicateSegmentName\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4e0f7094-aa1f-4fbf-b340-be805701c78e", "name": "Error inesperado o fallo de persistencia", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"name\": \"Clientes VIP\",\n \"type\": \"dynamic\",\n \"interGroupOperator\": \"and\",\n \"groups\": [\n {\n \"operator\": \"and\",\n \"conditions\": [\n {\n \"field\": \"age\",\n \"operator\": \"gt\",\n \"dataType\": \"numeric\",\n \"value\": 30\n }\n ]\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"Error al persistir el segmento\",\n \"data\": {\n \"code\": \"ErrPersistenceFailure\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b1fcab8c-aa8c-4882-8d31-87663aa76239", "name": "Obtiene un segmento por ID (V2) — incluye árbol de condiciones y metadata de conteo\n\nRetorna un único segmento filtrado por `_id` **y** `commerce_id` en una sola consulta.\nEl árbol de condiciones persistido se reconstruye en el formato `condition_tree` (mapper inverso, simétrico al de creación).\nNo existe recuento en vivo: `member_count` refleja el último valor persistido y `counters_run_at`/`counters_run_id`\nreflejan la última corrida del job de conteo (pueden ser `null`/ausentes si aún no ha corrido).\nEl 404 tiene la misma forma tanto si el segmento no existe como si pertenece a otro comercio (sin fuga de información).", "request": { "name": "Obtiene un segmento por ID (V2) — incluye árbol de condiciones y metadata de conteo\n\nRetorna un único segmento filtrado por `_id` **y** `commerce_id` en una sola consulta.\nEl árbol de condiciones persistido se reconstruye en el formato `condition_tree` (mapper inverso, simétrico al de creación).\nNo existe recuento en vivo: `member_count` refleja el último valor persistido y `counters_run_at`/`counters_run_id`\nreflejan la última corrida del job de conteo (pueden ser `null`/ausentes si aún no ha corrido).\nEl 404 tiene la misma forma tanto si el segmento no existe como si pertenece a otro comercio (sin fuga de información).", "description": { "content": "Obtiene un segmento por ID (V2) — incluye árbol de condiciones y metadata de conteo\n\nRetorna un único segmento filtrado por `_id` **y** `commerce_id` en una sola consulta.\nEl árbol de condiciones persistido se reconstruye en el formato `condition_tree` (mapper inverso, simétrico al de creación).\nNo existe recuento en vivo: `member_count` refleja el último valor persistido y `counters_run_at`/`counters_run_id`\nreflejan la última corrida del job de conteo (pueden ser `null`/ausentes si aún no ha corrido).\nEl 404 tiene la misma forma tanto si el segmento no existe como si pertenece a otro comercio (sin fuga de información).", "type": "text/plain" }, "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id", ":segmentationId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "{{commerceId}}", "key": "commerce_id", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) ID del segmento (ObjectID hexadecimal de Mongo)" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET" }, "response": [ { "id": "3e48f888-6633-4e34-a466-47d9dec226cc", "name": "Segmento encontrado", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id", ":segmentationId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) ID del segmento (ObjectID hexadecimal de Mongo)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 200,\n \"data\": {\n \"id\": \"665f1a2b3c4d5e6f7a8b9c0d\",\n \"name\": \"Clientes VIP Bogotá\",\n \"type\": \"dynamic\",\n \"status\": \"active\",\n \"condition_tree\": {\n \"interGroupOperator\": \"AND\",\n \"groups\": [\n {\n \"operator\": \"OR\",\n \"conditions\": [\n {\n \"attributeId\": \"12\",\n \"field\": \"total_spending\",\n \"operator\": \"gte\",\n \"dataType\": \"number\",\n \"value\": 100000\n }\n ]\n }\n ]\n },\n \"condition_tree_available\": true,\n \"member_count\": 42,\n \"created_at\": \"2026-07-01T10:00:00Z\",\n \"updated_at\": \"2026-07-05T08:30:00Z\",\n \"counters_run_at\": null\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "be0ed9c8-cf42-4f78-b79c-748ea987f62e", "name": "commerce_id inválido (no entero o <= 0) o segmentationId vacío/hex inválido", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id", ":segmentationId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) ID del segmento (ObjectID hexadecimal de Mongo)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"El identificador del comercio es inválido\",\n \"data\": {\n \"code\": \"ErrInvalidCommerceID\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "5c009704-0279-49e3-943d-41a868f5353b", "name": "Segmento no encontrado (no existe o pertenece a otro comercio — misma forma en ambos casos)", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id", ":segmentationId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) ID del segmento (ObjectID hexadecimal de Mongo)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"El segmento no existe\",\n \"data\": {\n \"code\": \"ErrSegmentationNotFound\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "34766d29-59ee-4c82-9f1d-0828f9d77320", "name": "Error inesperado consultando el segmento", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id", ":segmentationId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) ID del segmento (ObjectID hexadecimal de Mongo)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"Error al obtener el segmento\",\n \"data\": {\n \"code\": \"ErrGetSegmentationFailure\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c4ccfbb0-9ae9-4845-aa89-6a421df2305d", "name": "Actualiza (full-replace) un segmento existente por ID (V2)\n\nEdita un segmento identificado por `_id` **y** `commerce_id` en una sola operación. El cuerpo tiene el\nmismo formato groups (condition tree) usado en la creación — reemplaza `name`, `type`, `condition_tree`\ny `filters[]` por completo.\n\n- El recuento de miembros (`member_count`) se **recalcula de forma síncrona** en cada edición, tanto para\n `static` como para `dynamic` — la respuesta siempre refleja el conteo fresco.\n- Si `type` es `static`, además se dispara en segundo plano el refresco de buckets de audiencia (no bloquea\n la respuesta 200 ni afecta el `member_count` ya persistido).\n- El nombre debe ser único (case-insensitive) entre los demás segmentos del comercio, **excluyendo el\n propio segmento** — renombrar un segmento a su propio nombre actual está permitido.\n- El 404 tiene la misma forma tanto si el segmento no existe como si pertenece a otro comercio (sin fuga\n de información).\n- Si el segmento tiene entradas en `consumers[]` (registro de ocupación), la edición se bloquea con `422`\n `ErrSegmentationInUse` — mismo gate de ocupación que el delete v2. Cualquier PATCH queda bloqueado\n mientras el segmento esté marcado en uso.", "request": { "name": "Actualiza (full-replace) un segmento existente por ID (V2)\n\nEdita un segmento identificado por `_id` **y** `commerce_id` en una sola operación. El cuerpo tiene el\nmismo formato groups (condition tree) usado en la creación — reemplaza `name`, `type`, `condition_tree`\ny `filters[]` por completo.\n\n- El recuento de miembros (`member_count`) se **recalcula de forma síncrona** en cada edición, tanto para\n `static` como para `dynamic` — la respuesta siempre refleja el conteo fresco.\n- Si `type` es `static`, además se dispara en segundo plano el refresco de buckets de audiencia (no bloquea\n la respuesta 200 ni afecta el `member_count` ya persistido).\n- El nombre debe ser único (case-insensitive) entre los demás segmentos del comercio, **excluyendo el\n propio segmento** — renombrar un segmento a su propio nombre actual está permitido.\n- El 404 tiene la misma forma tanto si el segmento no existe como si pertenece a otro comercio (sin fuga\n de información).\n- Si el segmento tiene entradas en `consumers[]` (registro de ocupación), la edición se bloquea con `422`\n `ErrSegmentationInUse` — mismo gate de ocupación que el delete v2. Cualquier PATCH queda bloqueado\n mientras el segmento esté marcado en uso.", "description": { "content": "Actualiza (full-replace) un segmento existente por ID (V2)\n\nEdita un segmento identificado por `_id` **y** `commerce_id` en una sola operación. El cuerpo tiene el\nmismo formato groups (condition tree) usado en la creación — reemplaza `name`, `type`, `condition_tree`\ny `filters[]` por completo.\n\n- El recuento de miembros (`member_count`) se **recalcula de forma síncrona** en cada edición, tanto para\n `static` como para `dynamic` — la respuesta siempre refleja el conteo fresco.\n- Si `type` es `static`, además se dispara en segundo plano el refresco de buckets de audiencia (no bloquea\n la respuesta 200 ni afecta el `member_count` ya persistido).\n- El nombre debe ser único (case-insensitive) entre los demás segmentos del comercio, **excluyendo el\n propio segmento** — renombrar un segmento a su propio nombre actual está permitido.\n- El 404 tiene la misma forma tanto si el segmento no existe como si pertenece a otro comercio (sin fuga\n de información).\n- Si el segmento tiene entradas en `consumers[]` (registro de ocupación), la edición se bloquea con `422`\n `ErrSegmentationInUse` — mismo gate de ocupación que el delete v2. Cualquier PATCH queda bloqueado\n mientras el segmento esté marcado en uso.", "type": "text/plain" }, "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id", ":segmentationId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "{{commerceId}}", "key": "commerce_id", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) ID del segmento (ObjectID hexadecimal de Mongo)" } ] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"name\": \"\",\n \"type\": \"\",\n \"groups\": [\n {\n \"operator\": \"\",\n \"conditions\": [\n {\n \"attributeId\": \"\",\n \"field\": \"\",\n \"operator\": \"\",\n \"dataType\": \"\",\n \"value\": {},\n \"subFilters\": [\n \"\",\n \"\"\n ]\n },\n {\n \"attributeId\": \"\",\n \"field\": \"\",\n \"operator\": \"\",\n \"dataType\": \"\",\n \"value\": {},\n \"subFilters\": [\n \"\",\n \"\"\n ]\n }\n ]\n },\n {\n \"operator\": \"\",\n \"conditions\": [\n {\n \"attributeId\": \"\",\n \"field\": \"\",\n \"operator\": \"\",\n \"dataType\": \"\",\n \"value\": {},\n \"subFilters\": [\n \"\",\n \"\"\n ]\n },\n {\n \"attributeId\": \"\",\n \"field\": \"\",\n \"operator\": \"\",\n \"dataType\": \"\",\n \"value\": {},\n \"subFilters\": [\n \"\",\n \"\"\n ]\n }\n ]\n }\n ],\n \"interGroupOperator\": \"and\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "3f91f2ab-b166-40fb-9d37-fa1e6261ed5b", "name": "Segmento actualizado con éxito — member_count refleja el recuento fresco", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id", ":segmentationId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) ID del segmento (ObjectID hexadecimal de Mongo)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"name\": \"Clientes VIP\",\n \"type\": \"dynamic\",\n \"interGroupOperator\": \"and\",\n \"groups\": [\n {\n \"operator\": \"and\",\n \"conditions\": [\n {\n \"field\": \"age\",\n \"operator\": \"gt\",\n \"dataType\": \"numeric\",\n \"value\": 30\n }\n ]\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 200,\n \"data\": {\n \"id\": \"665f1a2b3c4d5e6f7a8b9c0d\",\n \"name\": \"Clientes VIP\",\n \"type\": \"dynamic\",\n \"status\": \"active\",\n \"condition_tree\": {\n \"interGroupOperator\": \"and\",\n \"groups\": [\n {\n \"operator\": \"and\",\n \"conditions\": [\n {\n \"field\": \"age\",\n \"operator\": \"gt\",\n \"dataType\": \"numeric\",\n \"value\": 30\n }\n ]\n }\n ]\n },\n \"condition_tree_available\": true,\n \"member_count\": 77,\n \"created_at\": \"2026-07-01T10:00:00Z\",\n \"updated_at\": \"2026-07-09T06:00:00Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e9362b72-a820-418b-a3f0-f866c2eddad3", "name": "commerce_id/segmentationId inválido, o 'type' ausente/inválido", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id", ":segmentationId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) ID del segmento (ObjectID hexadecimal de Mongo)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"name\": \"Clientes VIP\",\n \"type\": \"dynamic\",\n \"interGroupOperator\": \"and\",\n \"groups\": [\n {\n \"operator\": \"and\",\n \"conditions\": [\n {\n \"field\": \"age\",\n \"operator\": \"gt\",\n \"dataType\": \"numeric\",\n \"value\": 30\n }\n ]\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"El identificador del comercio es inválido\",\n \"data\": {\n \"code\": \"ErrInvalidCommerceID\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "482870f8-63ea-48b5-998f-a7ab11b3ac2c", "name": "Segmento no encontrado (no existe o pertenece a otro comercio — misma forma en ambos casos)", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id", ":segmentationId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) ID del segmento (ObjectID hexadecimal de Mongo)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"name\": \"Clientes VIP\",\n \"type\": \"dynamic\",\n \"interGroupOperator\": \"and\",\n \"groups\": [\n {\n \"operator\": \"and\",\n \"conditions\": [\n {\n \"field\": \"age\",\n \"operator\": \"gt\",\n \"dataType\": \"numeric\",\n \"value\": 30\n }\n ]\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"El segmento no existe\",\n \"data\": {\n \"code\": \"ErrSegmentationNotFound\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "b88defad-c1c8-4bda-b15b-52653e3dcc80", "name": "Error semántico — segmento en uso, nombre duplicado (excluyendo el propio segmento) o árbol incompleto", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id", ":segmentationId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) ID del segmento (ObjectID hexadecimal de Mongo)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"name\": \"Clientes VIP\",\n \"type\": \"dynamic\",\n \"interGroupOperator\": \"and\",\n \"groups\": [\n {\n \"operator\": \"and\",\n \"conditions\": [\n {\n \"field\": \"age\",\n \"operator\": \"gt\",\n \"dataType\": \"numeric\",\n \"value\": 30\n }\n ]\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"El segmento está en uso y no puede modificarse\",\n \"data\": {\n \"code\": \"ErrSegmentationInUse\",\n \"blocking_reasons\": [\n \"occupancy\"\n ],\n \"consumers\": [\n {\n \"consumer_type\": \"leaderboard\",\n \"consumer_id\": \"lb_123\"\n }\n ]\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9f0231ea-0458-4f6d-a56b-d33fb794fa3f", "name": "Fallo en el recálculo síncrono del conteo o en la persistencia — no se escribe nada", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id", ":segmentationId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) ID del segmento (ObjectID hexadecimal de Mongo)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "PATCH", "body": { "mode": "raw", "raw": "{\n \"name\": \"Clientes VIP\",\n \"type\": \"dynamic\",\n \"interGroupOperator\": \"and\",\n \"groups\": [\n {\n \"operator\": \"and\",\n \"conditions\": [\n {\n \"field\": \"age\",\n \"operator\": \"gt\",\n \"dataType\": \"numeric\",\n \"value\": 30\n }\n ]\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"Error al actualizar el segmento\",\n \"data\": {\n \"code\": \"ErrUpdateSegmentationFailure\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "282ad028-694c-420a-8921-4d9d7974eb08", "name": "Elimina permanentemente un segmento por ID (V2) — dual gate + hard delete atómico\n\nElimina el segmento identificado por `_id` **y** `commerce_id` en una sola operación atómica. No\nconfundir con el endpoint legacy `DELETE /segmentations/{segmentationID}` (sin scope de comercio,\nmapeo de errores plano) — ambos coexisten, el legacy queda sin cambios.\n\nLa eliminación solo procede si ambos \"gates\" pasan, evaluados en orden secuencial (short-circuit —\nsi el gate 1 bloquea, el gate 2 nunca se evalúa):\n\n1. **Gate 1 — registro de ocupación**: el segmento no debe tener entradas en `consumers[]`\n (ver `PUT .../occupancy`).\n2. **Gate 2 — campañas activas (legacy)**: el segmento no debe estar vinculado a una campaña con\n `send_status` en `programmed`, `processing` o `in_approval`.\n\nSi cualquiera de los dos gates bloquea, la respuesta es `422` con `blocking_reasons` indicando cuál\ngate falló y, cuando el bloqueo es por ocupación, la lista `consumers`. El detalle de campañas\nlegacy **no** se expone en el contrato (migración suave: gate 2 sigue bloqueando internamente\nhasta que campañas adopte ocupación). Si ambos pasan, el borrado es\nun `DeleteOne` de un solo documento — no hay borrado parcial si la operación falla (`500`).\n\nEl filtro del `DeleteOne` está condicionado a `consumers` vacío/ausente además de `_id`+`commerce_id`,\ncerrando la ventana de carrera entre la lectura del gate 1 y el borrado: si un `mark` concurrente\nllega justo antes del `DeleteOne`, el filtro no matchea ningún documento (`DeletedCount==0`) en vez de\nborrar un segmento que acaba de pasar a estar en uso. En ese caso el servicio reevalúa: si el segmento\nahora tiene `consumers` → `422` ocupación; si ya no existe/no es de ese comercio → `404`; cualquier\notro caso → `500`.\n\nPara audiencias estáticas con buckets materializados, la limpieza de `segmentation_buckets` se\ndispara en segundo plano (fire-and-forget) y no bloquea la respuesta `204`.\n\nEl `404` tiene la misma forma tanto si el segmento no existe como si pertenece a otro comercio (sin\nfuga de información).", "request": { "name": "Elimina permanentemente un segmento por ID (V2) — dual gate + hard delete atómico\n\nElimina el segmento identificado por `_id` **y** `commerce_id` en una sola operación atómica. No\nconfundir con el endpoint legacy `DELETE /segmentations/{segmentationID}` (sin scope de comercio,\nmapeo de errores plano) — ambos coexisten, el legacy queda sin cambios.\n\nLa eliminación solo procede si ambos \"gates\" pasan, evaluados en orden secuencial (short-circuit —\nsi el gate 1 bloquea, el gate 2 nunca se evalúa):\n\n1. **Gate 1 — registro de ocupación**: el segmento no debe tener entradas en `consumers[]`\n (ver `PUT .../occupancy`).\n2. **Gate 2 — campañas activas (legacy)**: el segmento no debe estar vinculado a una campaña con\n `send_status` en `programmed`, `processing` o `in_approval`.\n\nSi cualquiera de los dos gates bloquea, la respuesta es `422` con `blocking_reasons` indicando cuál\ngate falló y, cuando el bloqueo es por ocupación, la lista `consumers`. El detalle de campañas\nlegacy **no** se expone en el contrato (migración suave: gate 2 sigue bloqueando internamente\nhasta que campañas adopte ocupación). Si ambos pasan, el borrado es\nun `DeleteOne` de un solo documento — no hay borrado parcial si la operación falla (`500`).\n\nEl filtro del `DeleteOne` está condicionado a `consumers` vacío/ausente además de `_id`+`commerce_id`,\ncerrando la ventana de carrera entre la lectura del gate 1 y el borrado: si un `mark` concurrente\nllega justo antes del `DeleteOne`, el filtro no matchea ningún documento (`DeletedCount==0`) en vez de\nborrar un segmento que acaba de pasar a estar en uso. En ese caso el servicio reevalúa: si el segmento\nahora tiene `consumers` → `422` ocupación; si ya no existe/no es de ese comercio → `404`; cualquier\notro caso → `500`.\n\nPara audiencias estáticas con buckets materializados, la limpieza de `segmentation_buckets` se\ndispara en segundo plano (fire-and-forget) y no bloquea la respuesta `204`.\n\nEl `404` tiene la misma forma tanto si el segmento no existe como si pertenece a otro comercio (sin\nfuga de información).", "description": { "content": "Elimina permanentemente un segmento por ID (V2) — dual gate + hard delete atómico\n\nElimina el segmento identificado por `_id` **y** `commerce_id` en una sola operación atómica. No\nconfundir con el endpoint legacy `DELETE /segmentations/{segmentationID}` (sin scope de comercio,\nmapeo de errores plano) — ambos coexisten, el legacy queda sin cambios.\n\nLa eliminación solo procede si ambos \"gates\" pasan, evaluados en orden secuencial (short-circuit —\nsi el gate 1 bloquea, el gate 2 nunca se evalúa):\n\n1. **Gate 1 — registro de ocupación**: el segmento no debe tener entradas en `consumers[]`\n (ver `PUT .../occupancy`).\n2. **Gate 2 — campañas activas (legacy)**: el segmento no debe estar vinculado a una campaña con\n `send_status` en `programmed`, `processing` o `in_approval`.\n\nSi cualquiera de los dos gates bloquea, la respuesta es `422` con `blocking_reasons` indicando cuál\ngate falló y, cuando el bloqueo es por ocupación, la lista `consumers`. El detalle de campañas\nlegacy **no** se expone en el contrato (migración suave: gate 2 sigue bloqueando internamente\nhasta que campañas adopte ocupación). Si ambos pasan, el borrado es\nun `DeleteOne` de un solo documento — no hay borrado parcial si la operación falla (`500`).\n\nEl filtro del `DeleteOne` está condicionado a `consumers` vacío/ausente además de `_id`+`commerce_id`,\ncerrando la ventana de carrera entre la lectura del gate 1 y el borrado: si un `mark` concurrente\nllega justo antes del `DeleteOne`, el filtro no matchea ningún documento (`DeletedCount==0`) en vez de\nborrar un segmento que acaba de pasar a estar en uso. En ese caso el servicio reevalúa: si el segmento\nahora tiene `consumers` → `422` ocupación; si ya no existe/no es de ese comercio → `404`; cualquier\notro caso → `500`.\n\nPara audiencias estáticas con buckets materializados, la limpieza de `segmentation_buckets` se\ndispara en segundo plano (fire-and-forget) y no bloquea la respuesta `204`.\n\nEl `404` tiene la misma forma tanto si el segmento no existe como si pertenece a otro comercio (sin\nfuga de información).", "type": "text/plain" }, "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id", ":segmentationId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "{{commerceId}}", "key": "commerce_id", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) ID del segmento a eliminar (ObjectID hexadecimal de Mongo)" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "DELETE" }, "response": [ { "id": "17506fdb-6116-4e87-bbb9-ad1aa2a259d4", "name": "Segmento eliminado con éxito — sin cuerpo de respuesta", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id", ":segmentationId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) ID del segmento a eliminar (ObjectID hexadecimal de Mongo)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " } ], "method": "DELETE", "body": {} }, "status": "No Content", "code": 204, "header": [ { "key": "Content-Type", "value": "text/plain" } ], "body": "", "cookie": [], "_postman_previewlanguage": "text" }, { "id": "f0f1a691-4b0e-4fba-aa3b-e7809de03c21", "name": "commerce_id inválido (no entero o <= 0) o segmentationId vacío/hex inválido", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id", ":segmentationId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) ID del segmento a eliminar (ObjectID hexadecimal de Mongo)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"El identificador del comercio es inválido\",\n \"data\": {\n \"code\": \"ErrInvalidCommerceID\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "60c19b3a-2a30-4904-b679-8c66f0f192cc", "name": "Segmento no encontrado (no existe o pertenece a otro comercio — misma forma en ambos casos)", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id", ":segmentationId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) ID del segmento a eliminar (ObjectID hexadecimal de Mongo)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"El segmento no existe\",\n \"data\": {\n \"code\": \"ErrSegmentationNotFound\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9802980a-789a-45ae-a0a0-1b2629d9ca93", "name": "Segmento en uso — bloqueado por ocupación y/o campañas activas (dual gate)", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id", ":segmentationId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) ID del segmento a eliminar (ObjectID hexadecimal de Mongo)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Unprocessable Entity (WebDAV) (RFC 4918)", "code": 422, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"El segmento está en uso y no puede modificarse\",\n \"data\": {\n \"code\": \"ErrSegmentationInUse\",\n \"blocking_reasons\": [\n \"occupancy\"\n ],\n \"consumers\": [\n {\n \"consumer_type\": \"leaderboard\",\n \"consumer_id\": \"lb_123\"\n }\n ]\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "284f9e64-645d-4a73-a696-4c38abb2d91b", "name": "Fallo externo o de borrado — el segmento queda intacto (sin borrado parcial).\nCódigos diferenciados: `ErrCampaignsCheckFailure` (gate 2 / ms-campaigns inalcanzable o no-200)\nvs `ErrDeleteSegmentationFailure` (persistencia / re-eval inesperado).\n", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id", ":segmentationId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) ID del segmento a eliminar (ObjectID hexadecimal de Mongo)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "DELETE", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"Error al consultar campañas asociadas al segmento\",\n \"data\": {\n \"code\": \"ErrCampaignsCheckFailure\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "53732ab0-3519-465c-8e82-a9924311c083", "name": "Duplica un segmento existente en una copia independiente (V2)\n\nCrea una copia independiente del segmento identificado por `_id` **y** `commerce_id`. El cuerpo de la\npetición se **ignora por completo** — no se acepta nombre, tipo ni árbol de condiciones definidos por el\nusuario en esta llamada (el nombre se podrá editar luego vía el endpoint de actualización).\n\n- **Nombre**: se genera automáticamente como `\"Copia de {nombre origen}\"`; si ya existe un segmento con\n ese nombre para el comercio, se agrega un sufijo numérico (`\"(2)\"`, `\"(3)\"`, …) hasta encontrar uno\n disponible. Duplicar una copia encadena el prefijo (`\"Copia de Copia de X\"`), nunca lo deduplica.\n- **Árbol de condiciones**: se copia **verbatim** desde el origen — no se re-ejecuta ninguna validación\n de árbol; editar la copia o el origen después no afecta al otro.\n- **Tipo**: idéntico al del segmento origen (`static` o `dynamic`).\n- **Recuento de miembros**: se **recalcula de forma síncrona** en el momento de la duplicación, para\n `static` **y** `dynamic` — la respuesta siempre refleja el conteo fresco (nunca `0`).\n- Si el tipo resultante es `static`, además se dispara en segundo plano el pipeline de materialización de\n buckets de audiencia (no bloquea la respuesta `201`).\n- No se copia historial de recuento (`counters_run_at`/`counters_run_id`) ni membresía del origen.\n- El `404` tiene la misma forma tanto si el segmento no existe como si pertenece a otro comercio (sin\n fuga de información).", "request": { "name": "Duplica un segmento existente en una copia independiente (V2)\n\nCrea una copia independiente del segmento identificado por `_id` **y** `commerce_id`. El cuerpo de la\npetición se **ignora por completo** — no se acepta nombre, tipo ni árbol de condiciones definidos por el\nusuario en esta llamada (el nombre se podrá editar luego vía el endpoint de actualización).\n\n- **Nombre**: se genera automáticamente como `\"Copia de {nombre origen}\"`; si ya existe un segmento con\n ese nombre para el comercio, se agrega un sufijo numérico (`\"(2)\"`, `\"(3)\"`, …) hasta encontrar uno\n disponible. Duplicar una copia encadena el prefijo (`\"Copia de Copia de X\"`), nunca lo deduplica.\n- **Árbol de condiciones**: se copia **verbatim** desde el origen — no se re-ejecuta ninguna validación\n de árbol; editar la copia o el origen después no afecta al otro.\n- **Tipo**: idéntico al del segmento origen (`static` o `dynamic`).\n- **Recuento de miembros**: se **recalcula de forma síncrona** en el momento de la duplicación, para\n `static` **y** `dynamic` — la respuesta siempre refleja el conteo fresco (nunca `0`).\n- Si el tipo resultante es `static`, además se dispara en segundo plano el pipeline de materialización de\n buckets de audiencia (no bloquea la respuesta `201`).\n- No se copia historial de recuento (`counters_run_at`/`counters_run_id`) ni membresía del origen.\n- El `404` tiene la misma forma tanto si el segmento no existe como si pertenece a otro comercio (sin\n fuga de información).", "description": { "content": "Duplica un segmento existente en una copia independiente (V2)\n\nCrea una copia independiente del segmento identificado por `_id` **y** `commerce_id`. El cuerpo de la\npetición se **ignora por completo** — no se acepta nombre, tipo ni árbol de condiciones definidos por el\nusuario en esta llamada (el nombre se podrá editar luego vía el endpoint de actualización).\n\n- **Nombre**: se genera automáticamente como `\"Copia de {nombre origen}\"`; si ya existe un segmento con\n ese nombre para el comercio, se agrega un sufijo numérico (`\"(2)\"`, `\"(3)\"`, …) hasta encontrar uno\n disponible. Duplicar una copia encadena el prefijo (`\"Copia de Copia de X\"`), nunca lo deduplica.\n- **Árbol de condiciones**: se copia **verbatim** desde el origen — no se re-ejecuta ninguna validación\n de árbol; editar la copia o el origen después no afecta al otro.\n- **Tipo**: idéntico al del segmento origen (`static` o `dynamic`).\n- **Recuento de miembros**: se **recalcula de forma síncrona** en el momento de la duplicación, para\n `static` **y** `dynamic` — la respuesta siempre refleja el conteo fresco (nunca `0`).\n- Si el tipo resultante es `static`, además se dispara en segundo plano el pipeline de materialización de\n buckets de audiencia (no bloquea la respuesta `201`).\n- No se copia historial de recuento (`counters_run_at`/`counters_run_id`) ni membresía del origen.\n- El `404` tiene la misma forma tanto si el segmento no existe como si pertenece a otro comercio (sin\n fuga de información).", "type": "text/plain" }, "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id", ":segmentationId", "duplicate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "{{commerceId}}", "key": "commerce_id", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) ID del segmento origen a duplicar (ObjectID hexadecimal de Mongo)" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "response": [ { "id": "12a23cf2-5602-47e2-9695-3180b6d883bc", "name": "Segmento duplicado con éxito — nuevo id, nombre disambiguado, member_count fresco", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id", ":segmentationId", "duplicate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) ID del segmento origen a duplicar (ObjectID hexadecimal de Mongo)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status_code\": 201,\n \"data\": {\n \"id\": \"7a1b2c3d4e5f6a7b8c9d0e1f\",\n \"name\": \"Copia de Clientes VIP\",\n \"type\": \"dynamic\",\n \"status\": \"active\",\n \"condition_tree\": {\n \"interGroupOperator\": \"and\",\n \"groups\": [\n {\n \"operator\": \"and\",\n \"conditions\": [\n {\n \"field\": \"age\",\n \"operator\": \"gt\",\n \"dataType\": \"numeric\",\n \"value\": 30\n }\n ]\n }\n ]\n },\n \"condition_tree_available\": true,\n \"member_count\": 42,\n \"created_at\": \"2026-07-10T06:00:00Z\",\n \"updated_at\": \"2026-07-10T06:00:00Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "65017b97-b05e-46be-b079-0a46d289345e", "name": "commerce_id inválido (no entero o <= 0) o segmentationId vacío/hex inválido", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id", ":segmentationId", "duplicate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) ID del segmento origen a duplicar (ObjectID hexadecimal de Mongo)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"El identificador del comercio es inválido\",\n \"data\": {\n \"code\": \"ErrInvalidCommerceID\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3410019e-368b-43ac-ac43-8760c53a1e3f", "name": "Segmento no encontrado (no existe o pertenece a otro comercio — misma forma en ambos casos)", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id", ":segmentationId", "duplicate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) ID del segmento origen a duplicar (ObjectID hexadecimal de Mongo)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Not Found", "code": 404, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"El segmento no existe\",\n \"data\": {\n \"code\": \"ErrSegmentationNotFound\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "969e5638-6c71-4466-9e8c-5ab554b4d7e4", "name": "Fallo en el recálculo síncrono del conteo o en la persistencia — no se crea ningún registro parcial", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "v2", ":commerce_id", ":segmentationId", "duplicate" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) ID del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) ID del segmento origen a duplicar (ObjectID hexadecimal de Mongo)" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"Error al duplicar el segmento\",\n \"data\": {\n \"code\": \"ErrDuplicateSegmentationFailure\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "df57e594-df3c-4b0b-9510-0025e7088086", "name": "Retorna todas las segmentaciones del comercio", "request": { "name": "Retorna todas las segmentaciones del comercio", "description": { "content": "Retorna todas las segmentaciones del comercio", "type": "text/plain" }, "url": { "path": [ "v2", "crm", "api", "segmentations", ":commerceId" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "page", "value": "" }, { "disabled": false, "key": "sortField", "value": "" }, { "disabled": false, "key": "sortType", "value": "" }, { "disabled": false, "key": "search", "value": "" }, { "disabled": false, "key": "createdAfter", "value": "" }, { "disabled": false, "key": "createdBefore", "value": "" }, { "disabled": false, "key": "excludeOfferfitAudience", "value": "" }, { "disabled": false, "key": "includeAllSegment", "value": "false", "description": "Opt-in to prepend the synthetic `_all`/\"Todos\" row on page 1. Defaults to false." }, { "disabled": false, "key": "category", "value": "", "description": "(Required) Categoría de segmentación a filtrar: custom (personalizada), suggested (sugerida), manual (manual), all (todas las categorías)" } ], "variable": [ { "disabled": false, "type": "any", "value": "{{commerceId}}", "key": "commerceId", "description": "(Required) " } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET" }, "response": [ { "id": "56a44b20-461e-48dd-a98f-72cb0efc5039", "name": "Listado de todas las segmentaciones del comercio", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", ":commerceId" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "page", "value": "" }, { "key": "sortField", "value": "" }, { "key": "sortType", "value": "" }, { "key": "search", "value": "" }, { "key": "createdAfter", "value": "" }, { "key": "createdBefore", "value": "" }, { "key": "excludeOfferfitAudience", "value": "" }, { "key": "includeAllSegment", "value": "false" }, { "key": "category", "value": "all" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerceId", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 200,\n \"pagination\": {\n \"totalItems\": 10,\n \"totalPages\": 10,\n \"page\": 1,\n \"pageSize\": 1,\n \"hasNextPage\": true,\n \"hasPreviousPage\": false\n },\n \"data\": [\n {\n \"_id\": \"507f1f77bcf86cd799439011\",\n \"commerceId\": \"13\",\n \"branchId\": \"branch_123\",\n \"type\": \"dynamic\",\n \"category\": \"custom\",\n \"name\": \"Usuarios de bogotá\",\n \"totalClients\": 500,\n \"totalClientsSMS\": 450,\n \"totalClientsEmail\": 400,\n \"totalClientsOfferfit\": 50,\n \"totalClientsOfferfitSMS\": 45,\n \"totalClientsOfferfitEmail\": 40,\n \"contactableBauSMS\": 450,\n \"contactableBauEmail\": 400,\n \"contactableBauWhatsApp\": 480,\n \"createdAt\": \"2023-08-08T12:34:56Z\",\n \"version\": 1\n },\n {\n \"_id\": \"507f1f77bcf86cd799439011\",\n \"commerceId\": \"13\",\n \"branchId\": \"branch_123\",\n \"type\": \"dynamic\",\n \"category\": \"custom\",\n \"name\": \"Usuarios de bogotá\",\n \"totalClients\": 500,\n \"totalClientsSMS\": 450,\n \"totalClientsEmail\": 400,\n \"totalClientsOfferfit\": 50,\n \"totalClientsOfferfitSMS\": 45,\n \"totalClientsOfferfitEmail\": 40,\n \"contactableBauSMS\": 450,\n \"contactableBauEmail\": 400,\n \"contactableBauWhatsApp\": 480,\n \"createdAt\": \"2023-08-08T12:34:56Z\",\n \"version\": 1\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "d95b5fe3-b19d-4b19-a8e7-e42fe743c0c4", "name": "Retorna el detalle de una segmentación específica del comercio", "request": { "name": "Retorna el detalle de una segmentación específica del comercio", "description": { "content": "Retorna el detalle de una segmentación específica del comercio", "type": "text/plain" }, "url": { "path": [ "v2", "crm", "api", "segmentations", ":segmentationId", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) " } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET" }, "response": [ { "id": "207b3d95-1e86-40f6-8d1b-803f6cb8bcec", "name": "Detalle de la segmentación solicitada", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", ":segmentationId", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 200,\n \"data\": {\n \"_id\": \"66be774f971b7144a364cb85\",\n \"name\": \"prueba-lista-dinamica-and-or\",\n \"type\": \"dynamic\",\n \"category\": \"custom\",\n \"filtersApplied\": [\n {\n \"operator\": \"none\",\n \"filters\": [\n {\n \"name\": \"Género\",\n \"category\": \"demographic\",\n \"operator\": \"none\",\n \"type\": \"MultipleString\",\n \"field\": \"gender\",\n \"value\": \"string\"\n },\n {\n \"name\": \"Género\",\n \"category\": \"demographic\",\n \"operator\": \"none\",\n \"type\": \"MultipleString\",\n \"field\": \"gender\",\n \"value\": \"string\"\n }\n ]\n },\n {\n \"operator\": \"none\",\n \"filters\": [\n {\n \"name\": \"Género\",\n \"category\": \"demographic\",\n \"operator\": \"none\",\n \"type\": \"MultipleString\",\n \"field\": \"gender\",\n \"value\": \"string\"\n },\n {\n \"name\": \"Género\",\n \"category\": \"demographic\",\n \"operator\": \"none\",\n \"type\": \"MultipleString\",\n \"field\": \"gender\",\n \"value\": \"string\"\n }\n ]\n }\n ],\n \"createdAt\": \"2024-08-15T21:46:55Z\"\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "7e8fd469-be9e-4fc2-9782-03834ea8e735", "name": "Bad request", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", ":segmentationId", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"value\": \"", "key": "segmentationId", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 200,\n \"message\": \"Unauthorized\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "51bae3fb-098a-4b23-bf8b-6c2704ae1878", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", ":segmentationId", "details" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "segmentationId", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"value\": \"", "key": "commerceId", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"_id\": \"507f1f77bcf86cd799439011\",\n \"name\": \"Usuarios preferenciales\"\n },\n {\n \"_id\": \"507f1f77bcf86cd799439011\",\n \"name\": \"Usuarios preferenciales\"\n }\n]", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "b73b6aa9-5774-4c7a-8b7b-c8237d2b13df", "name": "Retorna la información de los clientes de una segmentación del comercio", "request": { "name": "Retorna la información de los clientes de una segmentación del comercio", "description": { "content": "Retorna la información de los clientes de una segmentación del comercio", "type": "text/plain" }, "url": { "path": [ "v2", "crm", "api", "segmentations", ":segmentationId", "clients", ":commerceId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"clientSearch\": \"\",\n \"sortField\": \"\",\n \"sortType\": \"\",\n \"filters\": [\n {\n \"column\": \"\",\n \"items\": \"\"\n },\n {\n \"column\": \"\",\n \"items\": \"\"\n }\n ],\n \"page\": \"\",\n \"pageSize\": \"\",\n \"includeUsersOfferfit\": \"\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "a38a043f-025d-49dd-b9e4-8caa5c6de8e0", "name": "información de los clientes de una segmentación del comercio", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", ":segmentationId", "clients", ":commerceId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"clientSearch\": \"mariceth\",\n \"sortField\": \"name\",\n \"sortType\": \"asc\",\n \"filters\": [\n {\n \"column\": \"statusRfm\",\n \"items\": [\n \"Leal en potencia\"\n ]\n },\n {\n \"column\": \"statusRfm\",\n \"items\": [\n \"Leal en potencia\"\n ]\n }\n ],\n \"page\": 1,\n \"pageSize\": 10,\n \"includeUsersOfferfit\": false\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "[\n {\n \"statusCode\": 200,\n \"message\": \"successfully executed action\",\n \"data\": [\n {\n \"id\": \"101285b493dc4b4da1fd87161e97ca71\",\n \"fullname\": \"Mariceth Cruz\",\n \"firstName\": \"Mariceth\",\n \"lastName\": \"Cruz\",\n \"ageGroup\": \"45+\",\n \"age\": 30,\n \"gender\": \"female\",\n \"statusRfm\": \"Leal en potencia\",\n \"lealStatus\": \"activo\",\n \"birthday\": \"1960-03-20\",\n \"email\": \"maricthcruz@hotmail.com\",\n \"phone\": \"3100031111\",\n \"documentNumber\": \"33333333\",\n \"documentType\": \"Cédula Ciudadanía\",\n \"city\": \"Barranquilla\",\n \"averageTicket\": 521008,\n \"totalSpending\": 521008,\n \"lastRating\": 4,\n \"visits\": 1,\n \"lastVisit\": \"2024-03-19\",\n \"activePoints\": 521,\n \"usedPoints\": 0,\n \"totalPoints\": 521,\n \"claimedPrizesCount\": 0\n },\n {\n \"id\": \"101285b493dc4b4da1fd87161e97ca71\",\n \"fullname\": \"Mariceth Cruz\",\n \"firstName\": \"Mariceth\",\n \"lastName\": \"Cruz\",\n \"ageGroup\": \"45+\",\n \"age\": 30,\n \"gender\": \"female\",\n \"statusRfm\": \"Leal en potencia\",\n \"lealStatus\": \"activo\",\n \"birthday\": \"1960-03-20\",\n \"email\": \"maricthcruz@hotmail.com\",\n \"phone\": \"3100031111\",\n \"documentNumber\": \"33333333\",\n \"documentType\": \"Cédula Ciudadanía\",\n \"city\": \"Barranquilla\",\n \"averageTicket\": 521008,\n \"totalSpending\": 521008,\n \"lastRating\": 4,\n \"visits\": 1,\n \"lastVisit\": \"2024-03-19\",\n \"activePoints\": 521,\n \"usedPoints\": 0,\n \"totalPoints\": 521,\n \"claimedPrizesCount\": 0\n }\n ],\n \"pagination\": {\n \"currentPage\": 1,\n \"pageSize\": 10,\n \"hasNextPage\": true,\n \"hasPreviousPage\": false\n }\n },\n {\n \"statusCode\": 200,\n \"message\": \"successfully executed action\",\n \"data\": [\n {\n \"id\": \"101285b493dc4b4da1fd87161e97ca71\",\n \"fullname\": \"Mariceth Cruz\",\n \"firstName\": \"Mariceth\",\n \"lastName\": \"Cruz\",\n \"ageGroup\": \"45+\",\n \"age\": 30,\n \"gender\": \"female\",\n \"statusRfm\": \"Leal en potencia\",\n \"lealStatus\": \"activo\",\n \"birthday\": \"1960-03-20\",\n \"email\": \"maricthcruz@hotmail.com\",\n \"phone\": \"3100031111\",\n \"documentNumber\": \"33333333\",\n \"documentType\": \"Cédula Ciudadanía\",\n \"city\": \"Barranquilla\",\n \"averageTicket\": 521008,\n \"totalSpending\": 521008,\n \"lastRating\": 4,\n \"visits\": 1,\n \"lastVisit\": \"2024-03-19\",\n \"activePoints\": 521,\n \"usedPoints\": 0,\n \"totalPoints\": 521,\n \"claimedPrizesCount\": 0\n },\n {\n \"id\": \"101285b493dc4b4da1fd87161e97ca71\",\n \"fullname\": \"Mariceth Cruz\",\n \"firstName\": \"Mariceth\",\n \"lastName\": \"Cruz\",\n \"ageGroup\": \"45+\",\n \"age\": 30,\n \"gender\": \"female\",\n \"statusRfm\": \"Leal en potencia\",\n \"lealStatus\": \"activo\",\n \"birthday\": \"1960-03-20\",\n \"email\": \"maricthcruz@hotmail.com\",\n \"phone\": \"3100031111\",\n \"documentNumber\": \"33333333\",\n \"documentType\": \"Cédula Ciudadanía\",\n \"city\": \"Barranquilla\",\n \"averageTicket\": 521008,\n \"totalSpending\": 521008,\n \"lastRating\": 4,\n \"visits\": 1,\n \"lastVisit\": \"2024-03-19\",\n \"activePoints\": 521,\n \"usedPoints\": 0,\n \"totalPoints\": 521,\n \"claimedPrizesCount\": 0\n }\n ],\n \"pagination\": {\n \"currentPage\": 1,\n \"pageSize\": 10,\n \"hasNextPage\": true,\n \"hasPreviousPage\": false\n }\n }\n]", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "fdb63eb3-25b2-4753-8663-b4c2d402c0c1", "name": "Consulta los filtros de las segmentaciones basado en el id del comercio y clasificados por la categoria\ndel filtro", "request": { "name": "Consulta los filtros de las segmentaciones basado en el id del comercio y clasificados por la categoria\ndel filtro", "description": { "content": "Consulta los filtros de las segmentaciones basado en el id del comercio y clasificados por la categoria\ndel filtro", "type": "text/plain" }, "url": { "path": [ "v2", "crm", "api", "segmentations", "filters", "allowed-filters", ":idComercio" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "{{commerceId}}", "key": "idComercio", "description": "(Required) ID del comercio" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET" }, "response": [ { "id": "8e5815bc-ec41-4b96-8691-18d819a87e72", "name": "Successful", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "filters", "allowed-filters", ":idComercio" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "idComercio", "description": "(Required) ID del comercio" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 200,\n \"data\": [\n {\n \"category\": \"psicographic\",\n \"componentId\": \"leal-list-psicographic\",\n \"filters\": [\n {\n \"name\": \"Etiquetas\",\n \"description\": \"Métrica de marketing que significa Recencia, Frecuencia, Monetario.\",\n \"icon\": \"local_offer\",\n \"componentId\": \"leal-item-tags\",\n \"types\": [\n {\n \"field\": {\n \"value\": \"\"\n },\n \"name\": {\n \"value\": \"\"\n },\n \"weight\": {\n \"value\": \"\"\n }\n },\n {\n \"field\": {\n \"value\": \"\"\n },\n \"name\": {\n \"value\": \"\"\n },\n \"weight\": {\n \"value\": \"\"\n }\n }\n ]\n },\n {\n \"name\": \"Etiquetas\",\n \"description\": \"Métrica de marketing que significa Recencia, Frecuencia, Monetario.\",\n \"icon\": \"local_offer\",\n \"componentId\": \"leal-item-tags\",\n \"types\": [\n {\n \"field\": {\n \"value\": \"\"\n },\n \"name\": {\n \"value\": \"\"\n },\n \"weight\": {\n \"value\": \"\"\n }\n },\n {\n \"field\": {\n \"value\": \"\"\n },\n \"name\": {\n \"value\": \"\"\n },\n \"weight\": {\n \"value\": \"\"\n }\n }\n ]\n }\n ]\n },\n {\n \"category\": \"psicographic\",\n \"componentId\": \"leal-list-psicographic\",\n \"filters\": [\n {\n \"name\": \"Etiquetas\",\n \"description\": \"Métrica de marketing que significa Recencia, Frecuencia, Monetario.\",\n \"icon\": \"local_offer\",\n \"componentId\": \"leal-item-tags\",\n \"types\": [\n {\n \"field\": {\n \"value\": \"\"\n },\n \"name\": {\n \"value\": \"\"\n },\n \"weight\": {\n \"value\": \"\"\n }\n },\n {\n \"field\": {\n \"value\": \"\"\n },\n \"name\": {\n \"value\": \"\"\n },\n \"weight\": {\n \"value\": \"\"\n }\n }\n ]\n },\n {\n \"name\": \"Etiquetas\",\n \"description\": \"Métrica de marketing que significa Recencia, Frecuencia, Monetario.\",\n \"icon\": \"local_offer\",\n \"componentId\": \"leal-item-tags\",\n \"types\": [\n {\n \"field\": {\n \"value\": \"\"\n },\n \"name\": {\n \"value\": \"\"\n },\n \"weight\": {\n \"value\": \"\"\n }\n },\n {\n \"field\": {\n \"value\": \"\"\n },\n \"name\": {\n \"value\": \"\"\n },\n \"weight\": {\n \"value\": \"\"\n }\n }\n ]\n }\n ]\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "16d67a20-8af7-4c43-bad0-603f17fc303d", "name": "Bad request", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "filters", "allowed-filters", ":idComercio" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "idComercio", "description": "(Required) ID del comercio" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"value\": \"", "key": "idComercio", "description": "(Required) ID del comercio" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Unauthorized", "code": 401, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 200,\n \"message\": \"Unauthorized\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "921f585f-7141-4e9d-b370-c3a1f53914ac", "name": "Internal server error", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "filters", "allowed-filters", ":idComercio" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "idComercio", "description": "(Required) ID del comercio" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"value\": \"", "key": "filterName", "description": "(Required) " } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET" }, "response": [ { "id": "7fabe8b7-2a52-4329-bc14-cb51ff5c264a", "name": "Success Response", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "filters", ":filterName" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "filterName", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 200,\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Bogotá\"\n },\n {\n \"id\": 2,\n \"name\": \"Medellín\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "c7e2deab-623b-4a98-ad25-5ced3ba5f88f", "name": "Consulta audiencias sugeridas por Leal, para luego crearlas al comercio", "request": { "name": "Consulta audiencias sugeridas por Leal, para luego crearlas al comercio", "description": { "content": "Consulta audiencias sugeridas por Leal, para luego crearlas al comercio", "type": "text/plain" }, "url": { "path": [ "v2", "crm", "api", "segmentations", "suggested", ":commerceId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "{{commerceId}}", "key": "commerceId", "description": "(Required) " } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET" }, "response": [ { "id": "6bc8e95f-1196-4161-9fc1-5825b72450a9", "name": "Created successfully", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", "suggested", ":commerceId" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerceId", "description": "(Required) " } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"value\": \"\",\n \"filters\": [\n {\n \"field\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n },\n {\n \"field\": \"\",\n \"type\": \"\",\n \"value\": \"\"\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "20a26c01-fa55-4454-9801-1ae02dea04a4", "name": "total de clientes para unos filtros específicos", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "segmentations", ":commerceId", "total-clients" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"contactabilityChannel\": \"all\",\n \"filters\": [\n {\n \"field\": \"last_rating\",\n \"type\": \"MultipleNumber\",\n \"value\": [\n 8,\n 9,\n 10\n ]\n },\n {\n \"field\": \"last_rating\",\n \"type\": \"MultipleNumber\",\n \"value\": [\n 8,\n 9,\n 10\n ]\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 200,\n \"data\": {\n \"totalClients\": 294,\n \"totalClientsSMS\": 283,\n \"totalClientsEmail\": 270\n }\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] }, { "id": "3e426db3-63bc-4f53-9382-ea30f09f399b", "name": "Exportación", "description": { "content": "Descargas CSV de clientes y audiencias.", "type": "text/plain" }, "item": [ { "id": "cde0b287-45db-46e3-887f-99fdcf246db0", "name": "Create Export File", "request": { "name": "Create Export File", "description": { "content": "Crear una nueva descarga", "type": "text/plain" }, "url": { "path": [ "v2", "crm", "api", "exports", "new" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"idExportType\": \"\",\n \"commerceId\": \"\",\n \"uidCms\": \"\",\n \"fileName\": \"\",\n \"filters\": [\n {\n \"column\": \"\",\n \"items\": [\n \"\",\n \"\"\n ]\n },\n {\n \"column\": \"\",\n \"items\": [\n \"\",\n \"\"\n ]\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "id": "c51bb4af-15ad-4cdf-992a-0139ce2c1956", "name": "Created", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "exports", "new" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"idExportType\": \"\",\n \"commerceId\": \"\",\n \"uidCms\": \"\",\n \"fileName\": \"\",\n \"filters\": [\n {\n \"column\": \"\",\n \"items\": [\n \"\",\n \"\"\n ]\n },\n {\n \"column\": \"\",\n \"items\": [\n \"\",\n \"\"\n ]\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Created", "code": 201, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"id\": \"string\",\n \"url\": \"string\",\n \"createdAt\": \"string\",\n \"createdBy\": \"string\",\n \"status\": \"string\",\n \"retentionTime\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "e013a3a9-f865-4780-92b8-5d0589e4ae47", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "exports", "new" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"idExportType\": \"\",\n \"commerceId\": \"\",\n \"uidCms\": \"\",\n \"fileName\": \"\",\n \"filters\": [\n {\n \"column\": \"\",\n \"items\": [\n \"\",\n \"\"\n ]\n },\n {\n \"column\": \"\",\n \"items\": [\n \"\",\n \"\"\n ]\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 7187,\n \"message\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "9040ff3e-fc90-4b60-b366-5c789ab148c5", "name": "Internal Server Error", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "exports", "new" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "POST", "body": { "mode": "raw", "raw": "{\n \"idExportType\": \"\",\n \"commerceId\": \"\",\n \"uidCms\": \"\",\n \"fileName\": \"\",\n \"filters\": [\n {\n \"column\": \"\",\n \"items\": [\n \"\",\n \"\"\n ]\n },\n {\n \"column\": \"\",\n \"items\": [\n \"\",\n \"\"\n ]\n }\n ]\n}", "options": { "raw": { "language": "json" } } } }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 7187,\n \"message\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "6131961d-0daf-41e0-88ca-7aeaa1cf4603", "name": "Get Export File List", "request": { "name": "Get Export File List", "description": { "content": "Obtener la lista de descargas vigentes para un comercio", "type": "text/plain" }, "url": { "path": [ "v2", "crm", "api", "exports", "commerce", ":commerce_id", "type", ":export_type" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "{{commerceId}}", "key": "commerce_id", "description": "(Required) Identificador del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "export_type", "description": "(Required) Tipo de exportacion" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET" }, "response": [ { "id": "8c965b31-95b2-4ffc-881e-ba49cf5439d5", "name": "OK", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "exports", "commerce", ":commerce_id", "type", ":export_type" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) Identificador del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "export_type", "description": "(Required) Tipo de exportacion" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 6392,\n \"message\": \"string\",\n \"data\": [\n {\n \"id\": \"string\",\n \"url\": \"string\",\n \"createdAt\": \"string\",\n \"createdBy\": \"string\",\n \"status\": \"string\",\n \"retentionTime\": \"string\"\n },\n {\n \"id\": \"string\",\n \"url\": \"string\",\n \"createdAt\": \"string\",\n \"createdBy\": \"string\",\n \"status\": \"string\",\n \"retentionTime\": \"string\"\n }\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "c615ab0f-b693-4117-8017-93c8657a07c8", "name": "Bad Request", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "exports", "commerce", ":commerce_id", "type", ":export_type" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) Identificador del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "export_type", "description": "(Required) Tipo de exportacion" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 7187,\n \"message\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "19c2a8ac-ee24-450d-b7f7-8bac2692c142", "name": "Internal Server Error", "originalRequest": { "url": { "path": [ "v2", "crm", "api", "exports", "commerce", ":commerce_id", "type", ":export_type" ], "host": [ "{{baseUrl}}" ], "query": [], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "commerce_id", "description": "(Required) Identificador del comercio" }, { "disabled": false, "type": "any", "value": "", "key": "export_type", "description": "(Required) Tipo de exportacion" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: bearer", "type": "text/plain" }, "key": "Authorization", "value": "Bearer " }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"statusCode\": 7187,\n \"message\": \"string\"\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] } ], "event": [], "variable": [ { "key": "baseUrl", "value": "https://apiqa.leal.co", "type": "string" }, { "key": "apiKey", "value": "", "type": "string" }, { "key": "commerceId", "value": "", "type": "string" }, { "key": "sigv4", "value": "", "type": "string" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{apiKey}}", "type": "string" } ] }, "info": { "_postman_id": "16e16b28-808f-41da-a7de-3841e50fb321", "name": "APIs de integración de Leal", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "Documentación para integrar tu comercio con Leal.\nLa API key va en `Authorization: Bearer`. Leal te la entrega al activar el comercio.\nEn Puntos, envía también `X-API-Version: 1`.\nPara anular una acumulación o una redención, firma la llamada con AWS Signature Version 4.\n", "type": "text/plain" } } }