{"info":{"_postman_id":"d470d245-9dd4-4af5-9ae4-55100fd71b7a","name":"Envios API","description":"

La API de envios es una herramienta diseñada para facilitar la generación de etiquetas de envío con los principales transportistas en México. Esta integración permite a las empresas automatizar y optimizar sus procesos logísticos, ofreciendo las siguientes funcionalidades clave:

Generación de Guías Electrónicas: Permite crear etiquetas de envío de manera eficiente, adaptándose a las especificaciones de diversos carriers nacionales.
\n
Cotización de Envíos: Proporciona tarifas actualizadas para diferentes destinos y servicios, ayudando a seleccionar la opción más adecuada según las necesidades del negocio.
\n
Seguimiento de Paquetes: Ofrece información en tiempo real sobre el estado y la ubicación de los envíos, mejorando la transparencia y la comunicación con los clientes.
\n
Gestión de Usuarios: Facilita la administración de múltiples usuarios y sucursales, permitiendo un control centralizado de las operaciones logísticas.
\n

Al integrar esta API, las empresas pueden estandarizar costos, reducir tiempos de envío y mejorar la eficiencia operativa, adaptándose a las demandas del mercado mexicano.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"7659477","collectionId":"d470d245-9dd4-4af5-9ae4-55100fd71b7a","publishedId":"2sB2qdgzey","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-05-27T21:38:04.000Z"},"item":[{"name":"Proceso implementacion (ejemplo)","item":[],"id":"4cbfd5a4-8d18-4c8d-b8ea-9273b35e1fce","description":"

RESUMEN DE PROCESO ACTUALIZADO

1. Autenticación del Usuario (Token en Encabezado Authorization)

Para todas las solicitudes, debes incluir el token de autenticación en el encabezado de la solicitud. No es necesario un endpoint específico de autenticación.

Authorization: {access_token}

2. Consulta y Registro de Direcciones

Paso 2.1: Consultar Colonias en Base al Código Postal `/colonias/?cp={codigo_postal}`

Este paso permite consultar las colonias asociadas a un código postal específico.

Endpoint: GET /colonias?cp={codigo_postal}
\n
Descripción: Devuelve una lista de colonias correspondientes al código postal proporcionado.
\n
GET /colonias?cp=12345
\n
[ { \"colonia\": \"Colonia Centro\", \"cp\": \"12345\", \"estado\": \"Estado de Ejemplo\", \"ciudad\": \"Ciudad de Ejemplo\" }, { \"colonia\": \"Colonia Norte\", \"cp\": \"12345\", \"estado\": \"Estado de Ejemplo\", \"ciudad\": \"Ciudad de Ejemplo\" }]
\n

Paso 2.2: Registrar Dirección de Origen `/direcciones`

Este paso permite registrar una nueva dirección de origen en el sistema.

Endpoint: POST /direcciones
\n
Descripción: Registra una nueva dirección de origen en la base de datos y devuelve la información registrada, incluyendo el alias que se utilizará al crear el envío.
\n
{ \"cp\": \"20000\", \"ciudad\": \"Aguascalientes\", \"estado\": \"Aguascalientes\", \"colonia\": \"Centro\", \"nombre\": \"Juan Pérez\", \"email\": \"juan.perez@example.com\", \"telefono\": \"4491234567\", \"empresa\": \"Mi Empresa S.A.\", \"calle\": \"Av. Principal\", \"numero\": \"123\", \"referencia\": \"Frente al parque\", \"alias\": \"oficina_principal\"}
\n
{ \"cp\": \"20000\", \"ciudad\": \"Aguascalientes\", \"estado\": \"Aguascalientes\", \"colonia\": \"Centro\", \"nombre\": \"Juan Pérez\", \"email\": \"juan.perez@example.com\", \"telefono\": \"4491234567\", \"empresa\": \"Mi Empresa S.A.\", \"rfc\": \"XAXX010101000\", \"calle\": \"Av. Principal\", \"numero\": \"123\", \"referencia\": \"Frente al parque\", \"alias\": \"oficina_principal\", \"createdAt\": \"2024-08-18T12:00:00Z\", \"updatedAt\": \"2024-08-18T12:00:00Z\", \"id\": \"12345678\"}
\n

Paso 2.3: Registrar Dirección de Destino `/direcciones`

Este paso permite registrar una nueva dirección de destino en el sistema.

Endpoint: POST /direcciones
\n
Descripción: Registra una nueva dirección de destino en la base de datos y devuelve la información registrada, incluyendo el alias que se utilizará al crear el envío.
\n
{ \"cp\": \"20000\", \"ciudad\": \"Aguascalientes\", \"estado\": \"Aguascalientes\", \"colonia\": \"Centro\", \"nombre\": \"Juan Pérez\", \"email\": \"juan.perez@example.com\", \"telefono\": \"4491234567\", \"empresa\": \"Mi Empresa S.A.\", \"calle\": \"Av. Principal\", \"numero\": \"123\", \"referencia\": \"Frente al parque\", \"alias\": \"casa_cliente\"}
\n
{ \"cp\": \"20000\", \"ciudad\": \"Aguascalientes\", \"estado\": \"Aguascalientes\", \"colonia\": \"Centro\", \"nombre\": \"Juan Pérez\", \"email\": \"juan.perez@example.com\", \"telefono\": \"4491234567\", \"empresa\": \"Mi Empresa S.A.\", \"rfc\": \"XAXX010101000\", \"calle\": \"Av. Principal\", \"numero\": \"123\", \"referencia\": \"Frente al parque\", \"alias\": \"casa_cliente\", \"createdAt\": \"2024-08-18T12:00:00Z\", \"updatedAt\": \"2024-08-18T12:00:00Z\", \"id\": \"12345678\"}
\n

3. Cotización del Envío `/cotizar`

Antes de crear un envío, es necesario obtener una cotización que calcule el costo y detalles del envío.

Endpoint: POST /cotizar
\n
Descripción: Calcula la cotización del envío usando los datos del origen, destino, y dimensiones del paquete.
\n
{ \"origen\": \"20000\", \"destino\": \"10000\", \"peso\": \"5.0\", \"largo\": \"30\", \"alto\": \"10\", \"ancho\": \"20\"}
\n
[ { \"id\": \"20220659-3bb3-4fea-9f22-ccf7a66b2fde\", \"servicio\": \"terretres especial sin\", \"total\": 180 }, { \"id\": \"c9a95071-93a2-4c07-83d5-b9e609b6ced3\", \"servicio\": \"ESTAFETA con recoleccion Aereo 1 kilo\", \"total\": 1525 }]
\n

4. Buscar Información en el SAT `/sat?termino={terminoBusqueda}`

Permite buscar información relevante en el catálogo de productos y servicios SAT.

Endpoint: GET /sat?termino={terminoBusqueda}
\n
Descripción: Realiza una búsqueda en la base de datos SAT basada en el término de producto.
\n
GET /sat?termino=juguetes
\n
[ { \"codigo\": \"10111301\", \"descripcion\": \"Juguetes para mascotas\" }, { \"codigo\": \"60141000\", \"descripcion\": \"Juguetes\" }]
\n

5. Crear el Envío y Generar la Etiqueta `/envio`

Crea un nuevo envío en el sistema y genera una etiqueta.

Endpoint: POST /envio
\n
Descripción: Crea un envío y genera una etiqueta de envío usando los detalles proporcionados.
\n
{ \"origen_alias\": \"oficina_principal\", \"destino_alias\": \"casa_cliente\", \"peso\": \"5.0\", \"largo\": \"30\", \"alto\": \"10\", \"ancho\": \"20\", \"sat_id\": \"60141000\", \"contenido\": \"Juguetes\", \"servicio_id\": \"f5b839fb-dcb2-5daa-b407-19d86c9bb30c\"}
\n
[ { \"origen\": \"06060\", \"destino\": \"48300\", \"remitente\": \"Juan Pérez\", \"destinatario\": \"María López\", \"numero_guia\": \"1234567890\", \"url\": \"https://example.com/etiqueta/1234567890.pdf\" }]
\n

La etiqueta se encuentra en el campo url y es la que deberás usar para devolvérsela al cliente.

\n","_postman_id":"4cbfd5a4-8d18-4c8d-b8ea-9273b35e1fce","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"d470d245-9dd4-4af5-9ae4-55100fd71b7a","id":"d470d245-9dd4-4af5-9ae4-55100fd71b7a","name":"Envios API","type":"collection"}}},{"name":"Autenticacion","item":[],"id":"41d64425-1b23-4d0b-8f98-e6bf8b2d4d20","description":"

Obtener Token

Para obtener el token de autenticacion debes de ir a tu plataforma, iniciar sesion y en el area Dashboard ingresar la informacion solicitada en el siguiente cuadro:

\n\n

Una vez que ingreses la informacion da click en generar API Key:

\n\n

Te saldra una alerta indicando que la clave se esta generando, ahi tenemos que esperar hasta que nuestra clave aparezca.

\n\n

Una vez generada tu clave esta aparecera en la ventana. Recuerda copiarla y almacenarla en un lugar seguro.

\n\n

Autenticar API

Para agregar la autorización mediante API Key en el encabezado de la solicitud, la configuración quedaría de esta manera:

Encabezado de Autorización: Incluye el encabezado Authorization en tu solicitud HTTP.
\n
Formato del Valor: Usa {{token}} en el valor, donde {{token}} es una variable que contiene tu API Key.
\n

Esta configuración podría verse así:

Key: Authorization
\n
Value: {{token}}
\n

Ejemplo en la Solicitud HTTP

Si estás realizando la solicitud desde un entorno como Postman, asegúrate de definir {{token}} en las variables de tu entorno con el valor de tu API Key. Luego, coloca el encabezado en el apartado de Headers en tu solicitud:

\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value
Authorization	{{token}}

","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":false},"event":[{"listen":"prerequest","script":{"id":"ccf8f49c-7c8d-4865-9eda-77f6a9b9253b","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"2c0d9a10-7e85-4a11-9bd5-e5264ff5ff99","type":"text/javascript","packages":{},"exec":[""]}}],"_postman_id":"41d64425-1b23-4d0b-8f98-e6bf8b2d4d20"},{"name":"Direcciones","item":[{"name":"Crear Direccion","id":"d793e3ec-1fea-47f2-b0c5-e216238fddc0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"cp\": \"06060\", //(obligatorio)\r\n \"ciudad\": \"Cuauhtémoc\", //(obligatorio)\r\n \"estado\": \"Ciudad de México\", //(obligatorio)\r\n \"colonia\": \"Centro (Área 6)\", //(obligatorio)\r\n \"nombre\": \"Juan Pérez\", //(obligatorio)\r\n \"email\": \"juan.perez@example.com\", //(obligatorio)\r\n \"telefono\": \"5512345678\", //(obligatorio)\r\n \"empresa\": \"Empresa Ejemplo S.A.\", //(obligatorio)\r\n \"rfc\": \"ABC123456789\", //(opcional)\r\n \"calle\": \"Av. Insurgentes\", //(obligatorio)\r\n \"numero\": \"123\", //(obligatorio)\r\n \"referencia\": \"Referencia \", //(obligatorio no mayor a 25 caracteres)\r\n \"alias\": \"alias-destino\" //(obligatorio)\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://api-envios.appsincode.com/api/v2/direcciones","description":"

Crear nueva direccion

Este endpoint permite crear una nueva dirección validando la combinación de código postal, colonia, ciudad y estado antes de guardarla en la base de datos.

URL

/direcciones

Método

POST

Headers

Authorization: {{token}}

Cuerpo de la Solicitud (JSON)

json

{\n  \"cp\": \"12345\",\n  \"colonia\": \"Nombre de la Colonia\",\n  \"ciudad\": \"Nombre de la Ciudad\",\n  \"estado\": \"Nombre del Estado\",\n  \"otros_campos\": \"Otros valores requeridos para la dirección\"\n}\n\n

Ejemplo de Solicitud

plaintext

POST /direcciones\nContent-Type: application/json\n{\n  \"cp\": \"12345\",\n  \"colonia\": \"Centro\",\n  \"ciudad\": \"Ciudad de México\",\n  \"estado\": \"Ciudad de México\",\n  \"calle\": \"Calle Ejemplo\",\n  \"numero\": \"123\"\n}\n\n

Validaciones

Código Postal: El código postal (cp) debe ser válido. Si no se encuentran colonias asociadas, se devolverá un error.
\n
Colonia: La colonia especificada debe coincidir con alguna de las colonias asociadas al código postal.
\n
Ciudad: La ciudad especificada debe coincidir con la información asociada al código postal.
\n
Estado: El estado especificado debe coincidir con la información asociada al código postal.
\n

Respuestas

Respuesta Exitosa (201 Created)

Devuelve el objeto de la dirección creada.

{ \"_id\": \"id_de_la_direccion\", \"cp\": \"12345\", \"colonia\": \"Centro\", \"ciudad\": \"Ciudad de México\", \"estado\": \"Ciudad de México\", \"users\": \"id_del_usuario\", \"otros_campos\": \"Valores adicionales\"}

Errores Comunes

400 Bad Request: Cuando alguna validación falla.
\n
- { \"message\": \"Código postal no válido.\"}
  \n
- { \"message\": \"Colonia no válida.\", \"colonias\": [ { \"name\": \"Colonia 1\" }, { \"name\": \"Colonia 2\" } ]}
  \n
- { \"message\": \"Ciudad no válida.\", \"ciudades\": [ { \"city\": \"Ciudad Ejemplo\" } ]}
  \n
- { \"message\": \"Estado no válido.\", \"estados\": [ { \"state\": \"Estado Ejemplo\" } ]}
  \n
\n
{ \"message\": \"El valor del campo alias ya está en uso.\"}
\n
{ \"message\": \"Error al guardar la dirección en el servidor.\"}
\n

Logs Generados

Advertencia (WARN): Cuando ocurre un error de validación o duplicación de datos.
\n
Información (INFO): Cuando una nueva dirección se crea exitosamente.
\n
Error (ERROR): Cuando ocurre un error en el servidor durante el guardado de la dirección.
\n

EndFragment

\n","urlObject":{"path":["direcciones"],"host":["https://api-envios.appsincode.com/api/v2"],"query":[],"variable":[]}},"response":[{"id":"52490ad9-1290-4520-b3b7-58c24cf4dbdc","name":"201 - Created","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"cp\": \"06060\",\r\n \"ciudad\": \"Cuauhtémoc\",\r\n \"estado\": \"Ciudad de México\",\r\n \"colonia\": \"Centro (Área 6)\",\r\n \"nombre\": \"Juan Pérez\",\r\n \"email\": \"juan.perez@example.com\",\r\n \"telefono\": \"5512345678\",\r\n \"empresa\": \"Empresa Ejemplo S.A.\",\r\n \"rfc\": \"ABC123456789\",\r\n \"calle\": \"Av. Insurgentes\",\r\n \"numero\": \"123\",\r\n \"referencia\": \"Cerca del parque\",\r\n \"alias\": \"Casa Principal\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://api-envios.appsincode.com/api/v2/direcciones"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"472"},{"key":"ETag","value":"W/\"1d8-sCUMZiHXJ7JuHZYSYC2bIgTAtM8\""},{"key":"Set-Cookie","value":"connect.sid=s%3A1PiPF_wU2Fa6sJff1a0yvElh75GRbqgE.S1b0veLEvNBi1jFOeEFAg%2BIndPmbhZpJ6xQ2qXaKCqI; Path=/; HttpOnly"},{"key":"Date","value":"Sat, 02 Nov 2024 02:48:19 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"estado\": \"Ciudad de México\",\n \"colonia\": \"Centro (Área 6)\",\n \"nombre\": \"Juan Pérez\",\n \"email\": \"juan.perez@example.com\",\n \"telefono\": \"5512345678\",\n \"empresa\": \"Empresa Ejemplo S.A.\",\n \"rfc\": \"ABC123456789\",\n \"calle\": \"Av. Insurgentes\",\n \"numero\": \"123\",\n \"referencia\": \"Cerca del parque\",\n \"alias\": \"Casa Principal\",\n \"users\": \"672545a62df2f608d5f5dc88\",\n \"createdAt\": \"2024-11-02T02:48:19.076Z\",\n \"updatedAt\": \"2024-11-02T02:48:19.076Z\",\n \"id\": \"672592f30bc460c95a73f6c6\"\n}"},{"id":"4bad923e-7077-4d0e-a6f4-d997d27c40b3","name":"400 - Código postal no válido.","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"cp\": \"12345\",\r\n \"ciudad\": \"Ciudad de México\",\r\n \"estado\": \"Ciudad de México\",\r\n \"colonia\": \"Centro\",\r\n \"nombre\": \"Juan Pérez\",\r\n \"email\": \"juan.perez@example.com\",\r\n \"telefono\": \"5512345678\",\r\n \"empresa\": \"Empresa Ejemplo S.A.\",\r\n \"rfc\": \"ABC123456789\",\r\n \"calle\": \"Av. Insurgentes\",\r\n \"numero\": \"123\",\r\n \"referencia\": \"Cerca del parque\",\r\n \"alias\": \"Casa Principal\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://api-envios.appsincode.com/api/v2/direcciones"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"40"},{"key":"ETag","value":"W/\"28-ATpHuO5RyRa2ImQd9Q37yByuYh0\""},{"key":"Date","value":"Sat, 02 Nov 2024 02:31:04 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Código postal no válido.\"\n}"},{"id":"a4f58049-80ef-4a07-9885-d75b68891b45","name":"400 - Colonia no válida.","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"cp\": \"06060\",\r\n \"ciudad\": \"Ciudad de México\",\r\n \"estado\": \"Ciudad de México\",\r\n \"colonia\": \"Centro\",\r\n \"nombre\": \"Juan Pérez\",\r\n \"email\": \"juan.perez@example.com\",\r\n \"telefono\": \"5512345678\",\r\n \"empresa\": \"Empresa Ejemplo S.A.\",\r\n \"rfc\": \"ABC123456789\",\r\n \"calle\": \"Av. Insurgentes\",\r\n \"numero\": \"123\",\r\n \"referencia\": \"Cerca del parque\",\r\n \"alias\": \"Casa Principal\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://api-envios.appsincode.com/api/v2/direcciones"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"269"},{"key":"ETag","value":"W/\"10d-emYKBpD5duK+9vkrbUIEmr+WCUE\""},{"key":"Date","value":"Sat, 02 Nov 2024 02:31:57 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Colonia no válida.\",\n \"colonias\": [\n {\n \"id\": \"33be4014-6e9e-4fe5-aeb3-39d8eb9559d1\",\n \"created_at\": \"2023-12-22T19:28:43.875Z\",\n \"updated_at\": \"2023-12-22T19:28:43.875Z\",\n \"name\": \"Centro (Área 6)\",\n \"postal_code\": \"06060\",\n \"state\": \"Ciudad de México\",\n \"city\": \"Cuauhtémoc\"\n }\n ]\n}"},{"id":"9f00d8f9-e7a6-4daa-988e-13d77448e9df","name":"400 - Ciudad no válida.","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"cp\": \"06060\",\r\n \"ciudad\": \"Ciudad de México\",\r\n \"estado\": \"Ciudad de México\",\r\n \"colonia\": \"Centro (Área 6)\",\r\n \"nombre\": \"Juan Pérez\",\r\n \"email\": \"juan.perez@example.com\",\r\n \"telefono\": \"5512345678\",\r\n \"empresa\": \"Empresa Ejemplo S.A.\",\r\n \"rfc\": \"ABC123456789\",\r\n \"calle\": \"Av. Insurgentes\",\r\n \"numero\": \"123\",\r\n \"referencia\": \"Cerca del parque\",\r\n \"alias\": \"Casa Principal\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://api-envios.appsincode.com/api/v2/direcciones"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"268"},{"key":"ETag","value":"W/\"10c-zBrZ9frk2T+z3A5DM2jtT5LIscA\""},{"key":"Set-Cookie","value":"connect.sid=s%3AmdK52BoX5RTz-idPf65ZfJn5jutrQ9mc.cg3TI%2Bgv68CdbmT9uEGZ4BD9JN0O8xrpQVNII2uW%2BV0; Path=/; HttpOnly"},{"key":"Date","value":"Sat, 02 Nov 2024 02:35:10 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Ciudad no válida.\",\n \"ciudades\": [\n {\n \"id\": \"33be4014-6e9e-4fe5-aeb3-39d8eb9559d1\",\n \"created_at\": \"2023-12-22T19:28:43.875Z\",\n \"updated_at\": \"2023-12-22T19:28:43.875Z\",\n \"name\": \"Centro (Área 6)\",\n \"postal_code\": \"06060\",\n \"state\": \"Ciudad de México\",\n \"city\": \"Cuauhtémoc\"\n }\n ]\n}"},{"id":"7a1566f4-e344-4913-8e0a-802bb4c3e941","name":"400 - Estado no válido.","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"cp\": \"06060\",\r\n \"ciudad\": \"Cuauhtémoc\",\r\n \"estado\": \"Ciudad de Méxic\",\r\n \"colonia\": \"Centro (Área 6)\",\r\n \"nombre\": \"Juan Pérez\",\r\n \"email\": \"juan.perez@example.com\",\r\n \"telefono\": \"5512345678\",\r\n \"empresa\": \"Empresa Ejemplo S.A.\",\r\n \"rfc\": \"ABC123456789\",\r\n \"calle\": \"Av. Insurgentes\",\r\n \"numero\": \"123\",\r\n \"referencia\": \"Cerca del parque\",\r\n \"alias\": \"Casa Principal\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://api-envios.appsincode.com/api/v2/direcciones"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"267"},{"key":"ETag","value":"W/\"10b-OOBMZlIwjb2pQnzzIrq5lIYVXeA\""},{"key":"Set-Cookie","value":"connect.sid=s%3Az2l-KGPB7SHbbQrNJYQLrcRJ6i1Blepd.FiPGzOi9mblzhBv6dc275nsv8yVVo6TVOLA5rJstwJo; Path=/; HttpOnly"},{"key":"Date","value":"Sat, 02 Nov 2024 02:36:13 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Estado no válido.\",\n \"estados\": [\n {\n \"id\": \"33be4014-6e9e-4fe5-aeb3-39d8eb9559d1\",\n \"created_at\": \"2023-12-22T19:28:43.875Z\",\n \"updated_at\": \"2023-12-22T19:28:43.875Z\",\n \"name\": \"Centro (Área 6)\",\n \"postal_code\": \"06060\",\n \"state\": \"Ciudad de México\",\n \"city\": \"Cuauhtémoc\"\n }\n ]\n}"},{"id":"7fce7615-90b9-45ba-ba2e-e9603230703d","name":"400 - Errores de validacion","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"cp\": \"06060\",\r\n \"ciudad\": \"Cuauhtémoc\",\r\n \"estado\": \"Ciudad de México\",\r\n \"colonia\": \"Centro (Área 6)\",\r\n \"email\": \"juan.perezexample.com\",\r\n \"telefono\": \"551234567\",\r\n \"rfc\": \"ABC12345678\",\r\n \"referencia\": \"Cerca del parqueCerca del parqueCerca del parqueCerca del parqueCerca del parqueCerca del parqueCerca del parqueCerca del parque\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://api-envios.appsincode.com/api/v2/direcciones"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"479"},{"key":"ETag","value":"W/\"1df-kkToZMR7h+f3UX/dwcZbtp5czWw\""},{"key":"Set-Cookie","value":"connect.sid=s%3Agfc0oOYRnREa6sf6bo9r6Be1KicxivcE.1OPQ72UhyY%2FJOKlrBbMPA7WqyPQG6JLhJP5NhC15NMo; Path=/; HttpOnly"},{"key":"Date","value":"Sat, 02 Nov 2024 02:41:44 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Error de validación.\",\n \"detalles\": [\n \"El alias es obligatorio y debe ser único\",\n \"El número es obligatorio\",\n \"La calle es obligatoria\",\n \"La empresa es obligatoria\",\n \"El nombre es obligatorio\",\n \"juan.perezexample.com no es un email válido\",\n \"551234567 no es un número de teléfono válido. Debe ser un número de 10 dígitos sin espacios ni caracteres especiales.\",\n \"El campo debe estar vacío o tener al menos 12 caracteres.\",\n \"El campo debe tener máximo 35 caracteres.\"\n ]\n}"},{"id":"e6da102d-8b9c-499a-9fbc-8d69ed805b03","name":"400 - Error Referencia","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"cp\": \"06060\", //(obligatorio)\r\n \"ciudad\": \"Cuauhtémoc\", //(obligatorio)\r\n \"estado\": \"Ciudad de México\", //(obligatorio)\r\n \"colonia\": \"Centro (Área 6)\", //(obligatorio)\r\n \"nombre\": \"Juan Pérez\", //(obligatorio)\r\n \"email\": \"juan.perez@example.com\", //(obligatorio)\r\n \"telefono\": \"5512345678\", //(obligatorio)\r\n \"empresa\": \"Empresa Ejemplo S.A.\", //(obligatorio)\r\n \"rfc\": \"ABC123456789\", //(opcional)\r\n \"calle\": \"Av. Insurgentes\", //(obligatorio)\r\n \"numero\": \"123\", //(obligatorio)\r\n \"referencia\": \"Referencia menor a 25 caracteres\", //(obligatorio no mayor a 25 caracteres)\r\n \"alias\": \"Casa Principal 2\" //(obligatorio)\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://api-envios.appsincode.com/api/v2/direcciones"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 02 Dec 2024 18:02:40 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"104"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"ETag","value":"W/\"68-xPx9xM2XJ6pb7CBS4PMdmYeGYW4\""},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v4?s=YY975nLPsPvudA0JLWcueHQOc3%2FWoOeuPdjI7iwfveCdq9UjeSr%2BPwQ4S7NfjvC1ZNh8l3uCChCIjIzTTatxG0dIIj7LRDTVZOv1CWa3owe1JnYE2PGV%2BaJb4juOg%2FmKrLxPmGDQrv2NfX6P\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8ebd3ab22ec37986-DEN"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"},{"key":"server-timing","value":"cfL4;desc=\"?proto=TCP&rtt=67530&min_rtt=67208&rtt_var=19124&sent=41&recv=41&lost=0&retrans=0&sent_bytes=4405&recv_bytes=2661&delivery_rate=42018&cwnd=253&unsent_bytes=0&cid=75a72f28d6f4524d&ts=38248&x=0\""}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Error de validación.\",\n \"detalles\": [\n \"El campo referencia debe tener máximo 25 caracteres.\"\n ]\n}"},{"id":"c99a7ba5-80ec-4fe0-bfcd-5a237da27965","name":"500","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"cp\": \"06060\",\r\n \"ciudad\": \"Cuauhtémoc\",\r\n \"estado\": \"Ciudad de México\",\r\n \"colonia\": \"Centro (Área 6)\",\r\n \"nombre\": \"Juan Pérez\",\r\n \"email\": \"juan.perez@example.com\",\r\n \"telefono\": \"5512345678\",\r\n \"empresa\": \"Empresa Ejemplo S.A.\",\r\n \"rfc\": \"ABC123456789\",\r\n \"calle\": \"Av. Insurgentes\",\r\n \"numero\": \"123\",\r\n \"referencia\": \"Cerca del parque\",\r\n \"alias\": \"Casa Principal\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://api-envios.appsincode.com/api/v2/direcciones"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"60"},{"key":"ETag","value":"W/\"3c-px9tJlCX/LnCrcmLkZzc1/ayR88\""},{"key":"Set-Cookie","value":"connect.sid=s%3AlgAC7VS_8Tw3Pxpz_xbKPVFu0x_kOjAm.y9nHO0%2BIzJmBlHCgwrMWmL1OCDZy2XO5n0TrUSFCcCA; Path=/; HttpOnly"},{"key":"Date","value":"Sat, 02 Nov 2024 02:46:11 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Error al guardar la dirección en el servidor.\"\n}"}],"_postman_id":"d793e3ec-1fea-47f2-b0c5-e216238fddc0"},{"name":"Direccion por Id","id":"c30b969a-a1ff-4d7a-a7c4-9ee0326da8ec","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"https://api-envios.appsincode.com/api/v2/direcciones/","description":"

Obtener Dirección por Id

Este endpoint permite obtener una dirección específica a partir de su ID.

URL

/getDirecciones?id={direccion_id}

Método

GET

Headers

Authorization: {{token}}

Parámetros de Consulta

id (string): ID de la dirección en formato ObjectId de 24 caracteres en hexadecimal.

Ejemplo de Solicitud

GET /getDirecciones?id=60c72b2f9b1e8e5d88d2a48e\n\n

Validaciones

ID: El parámetro id debe ser un ObjectId de 24 caracteres en formato hexadecimal. Si no es válido, se devolverá un error.

Respuestas

Respuesta Exitosa (200 OK)

Devuelve el objeto de la dirección encontrada.

{ \"_id\": \"60c72b2f9b1e8e5d88d2a48e\", \"cp\": \"12345\", \"colonia\": \"Centro\", \"ciudad\": \"Ciudad de México\", \"estado\": \"Ciudad de México\", \"users\": \"id_del_usuario\", \"otros_campos\": \"Valores adicionales\"}

Errores Comunes

{ \"message\": \"ID no válido. Debe ser un ObjectId de 24 caracteres en formato hexadecimal.\"}
\n
{ \"message\": \"Dirección no encontrada con el ID 60c72b2f9b1e8e5d88d2a48e\"}
\n
{ \"message\": \"Error al obtener la dirección.\"}
\n

Logs Generados

Advertencia (WARN): Cuando el id no es válido o no se encuentra la dirección.
\n
Información (INFO): Cuando se recibe una solicitud para obtener una dirección y cuando la dirección es encontrada exitosamente.
\n
Error (ERROR): Cuando ocurre un error en el servidor durante la obtención de la dirección.
\n

\n","urlObject":{"path":["direcciones",""],"host":["https://api-envios.appsincode.com/api/v2"],"query":[],"variable":[]}},"response":[{"id":"e2ca51eb-13c4-452e-a032-c5751f3667cc","name":"200","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api-envios.appsincode.com/api/v2/direcciones?id=672592f30bc460c95a73f6c6","host":["https://api-envios.appsincode.com/api/v2"],"path":["direcciones"],"query":[{"key":"id","value":"672592f30bc460c95a73f6c6","type":"text"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"472"},{"key":"ETag","value":"W/\"1d8-sCUMZiHXJ7JuHZYSYC2bIgTAtM8\""},{"key":"Set-Cookie","value":"connect.sid=s%3A-zBjsJV-4ER-Uh76zQKx6xDInlS4qZAJ.yUfuBI6A%2BZu06cXS43sWurjJ43Fc0aT7lGUR4HKbn%2BQ; Path=/; HttpOnly"},{"key":"Date","value":"Sat, 02 Nov 2024 03:00:08 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"estado\": \"Ciudad de México\",\n \"colonia\": \"Centro (Área 6)\",\n \"nombre\": \"Juan Pérez\",\n \"email\": \"juan.perez@example.com\",\n \"telefono\": \"5512345678\",\n \"empresa\": \"Empresa Ejemplo S.A.\",\n \"rfc\": \"ABC123456789\",\n \"calle\": \"Av. Insurgentes\",\n \"numero\": \"123\",\n \"referencia\": \"Cerca del parque\",\n \"alias\": \"Casa Principal\",\n \"users\": \"672545a62df2f608d5f5dc88\",\n \"createdAt\": \"2024-11-02T02:48:19.076Z\",\n \"updatedAt\": \"2024-11-02T02:48:19.076Z\",\n \"id\": \"672592f30bc460c95a73f6c6\"\n}"},{"id":"ac59b0e2-59ca-4b86-a696-18231e237c1a","name":"400","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api-envios.appsincode.com/api/v2/direcciones?id=672592f30bc460c95a73f6c","host":["https://api-envios.appsincode.com/api/v2"],"path":["direcciones"],"query":[{"key":"id","value":"672592f30bc460c95a73f6c"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"90"},{"key":"ETag","value":"W/\"5a-av4nAMaZeQO+4ICj3HlL+vI07H4\""},{"key":"Set-Cookie","value":"connect.sid=s%3ACARZduwjUlSmYrViyUlXmOtfU3YEWzb6.sbjdAVeh%2FP0PeBp9UF13zI%2B%2F6L4cT5VJtiPq3ulbGiA; Path=/; HttpOnly"},{"key":"Date","value":"Sat, 02 Nov 2024 03:01:36 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"ID no válido. Debe ser un ObjectId de 24 caracteres en formato hexadecimal.\"\n}"},{"id":"3a6ba06c-c4e4-4125-af6d-703355b8141f","name":"403","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api-envios.appsincode.com/api/v2/direcciones?id=","host":["https://api-envios.appsincode.com/api/v2"],"path":["direcciones"],"query":[{"key":"id","value":"","description":"(obligatorio)"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"63"},{"key":"ETag","value":"W/\"3f-JsOakNwmFGGWce6cMQ3G34heark\""},{"key":"Set-Cookie","value":"connect.sid=s%3AkxXWy87YKxun16Q5Yec-CqljnkxAOFUX.nxttLJnLXzTIK0GqM6%2BW5mDjAGGsgh9RRun15xdaUa4; Path=/; HttpOnly"},{"key":"Date","value":"Sun, 03 Nov 2024 22:19:16 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"No tienes permiso para acceder a esta dirección.\"\n}"},{"id":"5071764d-1a66-42eb-9739-cc2fcbdae976","name":"404","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api-envios.appsincode.com/api/v2/direcciones?id=672592f30bc460c95a73f6c7","host":["https://api-envios.appsincode.com/api/v2"],"path":["direcciones"],"query":[{"key":"id","value":"672592f30bc460c95a73f6c7"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"73"},{"key":"ETag","value":"W/\"49-1ooB2n7F8aKxyWseonIqxaKqn7w\""},{"key":"Date","value":"Sat, 02 Nov 2024 03:01:56 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Dirección no encontrada con el ID 672592f30bc460c95a73f6c7\"\n}"}],"_postman_id":"c30b969a-a1ff-4d7a-a7c4-9ee0326da8ec"},{"name":"Borrar Direccion por Id","id":"cfbd0e4a-c6e2-40a1-832c-2f82ffbf2132","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":false},"method":"DELETE","header":[],"url":"https://api-envios.appsincode.com/api/v2/direcciones/","description":"

Obtener Dirección por Id

Este endpoint permite obtener una dirección específica a partir de su ID.

URL

/getDirecciones?id={direccion_id}

Método

GET

Headers

Authorization: {{token}}

Parámetros de Consulta

id (string): ID de la dirección en formato ObjectId de 24 caracteres en hexadecimal.

Ejemplo de Solicitud

GET /getDirecciones?id=60c72b2f9b1e8e5d88d2a48e\n\n

Validaciones

ID: El parámetro id debe ser un ObjectId de 24 caracteres en formato hexadecimal. Si no es válido, se devolverá un error.

Respuestas

Respuesta Exitosa (200 OK)

Devuelve el objeto de la dirección encontrada.

{ \"_id\": \"60c72b2f9b1e8e5d88d2a48e\", \"cp\": \"12345\", \"colonia\": \"Centro\", \"ciudad\": \"Ciudad de México\", \"estado\": \"Ciudad de México\", \"users\": \"id_del_usuario\", \"otros_campos\": \"Valores adicionales\"}

Errores Comunes

{ \"message\": \"ID no válido. Debe ser un ObjectId de 24 caracteres en formato hexadecimal.\"}
\n
{ \"message\": \"Dirección no encontrada con el ID 60c72b2f9b1e8e5d88d2a48e\"}
\n
{ \"message\": \"Error al obtener la dirección.\"}
\n

Logs Generados

Advertencia (WARN): Cuando el id no es válido o no se encuentra la dirección.
\n
Información (INFO): Cuando se recibe una solicitud para obtener una dirección y cuando la dirección es encontrada exitosamente.
\n
Error (ERROR): Cuando ocurre un error en el servidor durante la obtención de la dirección.
\n

\n","urlObject":{"path":["direcciones",""],"host":["https://api-envios.appsincode.com/api/v2"],"query":[],"variable":[]}},"response":[{"id":"052627cc-8952-4818-b7b1-0fc5d573793b","name":"200","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api-envios.appsincode.com/api/v2/direcciones?id=672592f30bc460c95a73f6c6","host":["https://api-envios.appsincode.com/api/v2"],"path":["direcciones"],"query":[{"key":"id","value":"672592f30bc460c95a73f6c6","type":"text"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"472"},{"key":"ETag","value":"W/\"1d8-sCUMZiHXJ7JuHZYSYC2bIgTAtM8\""},{"key":"Set-Cookie","value":"connect.sid=s%3A-zBjsJV-4ER-Uh76zQKx6xDInlS4qZAJ.yUfuBI6A%2BZu06cXS43sWurjJ43Fc0aT7lGUR4HKbn%2BQ; Path=/; HttpOnly"},{"key":"Date","value":"Sat, 02 Nov 2024 03:00:08 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"estado\": \"Ciudad de México\",\n \"colonia\": \"Centro (Área 6)\",\n \"nombre\": \"Juan Pérez\",\n \"email\": \"juan.perez@example.com\",\n \"telefono\": \"5512345678\",\n \"empresa\": \"Empresa Ejemplo S.A.\",\n \"rfc\": \"ABC123456789\",\n \"calle\": \"Av. Insurgentes\",\n \"numero\": \"123\",\n \"referencia\": \"Cerca del parque\",\n \"alias\": \"Casa Principal\",\n \"users\": \"672545a62df2f608d5f5dc88\",\n \"createdAt\": \"2024-11-02T02:48:19.076Z\",\n \"updatedAt\": \"2024-11-02T02:48:19.076Z\",\n \"id\": \"672592f30bc460c95a73f6c6\"\n}"},{"id":"22682240-4b1d-4605-afa3-939f64e135cf","name":"400","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api-envios.appsincode.com/api/v2/direcciones?id=672592f30bc460c95a73f6c","host":["https://api-envios.appsincode.com/api/v2"],"path":["direcciones"],"query":[{"key":"id","value":"672592f30bc460c95a73f6c"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"90"},{"key":"ETag","value":"W/\"5a-av4nAMaZeQO+4ICj3HlL+vI07H4\""},{"key":"Set-Cookie","value":"connect.sid=s%3ACARZduwjUlSmYrViyUlXmOtfU3YEWzb6.sbjdAVeh%2FP0PeBp9UF13zI%2B%2F6L4cT5VJtiPq3ulbGiA; Path=/; HttpOnly"},{"key":"Date","value":"Sat, 02 Nov 2024 03:01:36 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"ID no válido. Debe ser un ObjectId de 24 caracteres en formato hexadecimal.\"\n}"},{"id":"a5dacbd7-2f15-406e-aadf-c79e9e9d8ffd","name":"403","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api-envios.appsincode.com/api/v2/direcciones?id=","host":["https://api-envios.appsincode.com/api/v2"],"path":["direcciones"],"query":[{"key":"id","value":"","description":"(obligatorio)"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"63"},{"key":"ETag","value":"W/\"3f-JsOakNwmFGGWce6cMQ3G34heark\""},{"key":"Set-Cookie","value":"connect.sid=s%3AkxXWy87YKxun16Q5Yec-CqljnkxAOFUX.nxttLJnLXzTIK0GqM6%2BW5mDjAGGsgh9RRun15xdaUa4; Path=/; HttpOnly"},{"key":"Date","value":"Sun, 03 Nov 2024 22:19:16 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"No tienes permiso para acceder a esta dirección.\"\n}"},{"id":"84fce903-41c2-4842-95d7-073888474c9f","name":"404","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api-envios.appsincode.com/api/v2/direcciones?id=672592f30bc460c95a73f6c7","host":["https://api-envios.appsincode.com/api/v2"],"path":["direcciones"],"query":[{"key":"id","value":"672592f30bc460c95a73f6c7"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"73"},{"key":"ETag","value":"W/\"49-1ooB2n7F8aKxyWseonIqxaKqn7w\""},{"key":"Date","value":"Sat, 02 Nov 2024 03:01:56 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Dirección no encontrada con el ID 672592f30bc460c95a73f6c7\"\n}"}],"_postman_id":"cfbd0e4a-c6e2-40a1-832c-2f82ffbf2132"},{"name":"Actualizar Direccion por Id","id":"8b441945-fe6d-4f97-88ba-891313f349d1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":false},"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"colonia\": \"Azcapotzalco\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-envios.appsincode.com/api/v2/direcciones/","description":"

Obtener Dirección por Id

Este endpoint permite obtener una dirección específica a partir de su ID.

URL

/getDirecciones?id={direccion_id}

Método

GET

Headers

Authorization: {{token}}

Parámetros de Consulta

id (string): ID de la dirección en formato ObjectId de 24 caracteres en hexadecimal.

Ejemplo de Solicitud

GET /getDirecciones?id=60c72b2f9b1e8e5d88d2a48e\n\n

Validaciones

ID: El parámetro id debe ser un ObjectId de 24 caracteres en formato hexadecimal. Si no es válido, se devolverá un error.

Respuestas

Respuesta Exitosa (200 OK)

Devuelve el objeto de la dirección encontrada.

{ \"_id\": \"60c72b2f9b1e8e5d88d2a48e\", \"cp\": \"12345\", \"colonia\": \"Centro\", \"ciudad\": \"Ciudad de México\", \"estado\": \"Ciudad de México\", \"users\": \"id_del_usuario\", \"otros_campos\": \"Valores adicionales\"}

Errores Comunes

{ \"message\": \"ID no válido. Debe ser un ObjectId de 24 caracteres en formato hexadecimal.\"}
\n
{ \"message\": \"Dirección no encontrada con el ID 60c72b2f9b1e8e5d88d2a48e\"}
\n
{ \"message\": \"Error al obtener la dirección.\"}
\n

Logs Generados

Advertencia (WARN): Cuando el id no es válido o no se encuentra la dirección.
\n
Información (INFO): Cuando se recibe una solicitud para obtener una dirección y cuando la dirección es encontrada exitosamente.
\n
Error (ERROR): Cuando ocurre un error en el servidor durante la obtención de la dirección.
\n

\n","urlObject":{"path":["direcciones",""],"host":["https://api-envios.appsincode.com/api/v2"],"query":[],"variable":[]}},"response":[{"id":"8cde1764-0e32-4354-ac29-b9df45ca55ab","name":"200","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api-envios.appsincode.com/api/v2/direcciones?id=672592f30bc460c95a73f6c6","host":["https://api-envios.appsincode.com/api/v2"],"path":["direcciones"],"query":[{"key":"id","value":"672592f30bc460c95a73f6c6","type":"text"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"472"},{"key":"ETag","value":"W/\"1d8-sCUMZiHXJ7JuHZYSYC2bIgTAtM8\""},{"key":"Set-Cookie","value":"connect.sid=s%3A-zBjsJV-4ER-Uh76zQKx6xDInlS4qZAJ.yUfuBI6A%2BZu06cXS43sWurjJ43Fc0aT7lGUR4HKbn%2BQ; Path=/; HttpOnly"},{"key":"Date","value":"Sat, 02 Nov 2024 03:00:08 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"estado\": \"Ciudad de México\",\n \"colonia\": \"Centro (Área 6)\",\n \"nombre\": \"Juan Pérez\",\n \"email\": \"juan.perez@example.com\",\n \"telefono\": \"5512345678\",\n \"empresa\": \"Empresa Ejemplo S.A.\",\n \"rfc\": \"ABC123456789\",\n \"calle\": \"Av. Insurgentes\",\n \"numero\": \"123\",\n \"referencia\": \"Cerca del parque\",\n \"alias\": \"Casa Principal\",\n \"users\": \"672545a62df2f608d5f5dc88\",\n \"createdAt\": \"2024-11-02T02:48:19.076Z\",\n \"updatedAt\": \"2024-11-02T02:48:19.076Z\",\n \"id\": \"672592f30bc460c95a73f6c6\"\n}"},{"id":"07b7b781-e2c6-4fe0-a07b-1d4d103282bf","name":"400","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api-envios.appsincode.com/api/v2/direcciones?id=672592f30bc460c95a73f6c","host":["https://api-envios.appsincode.com/api/v2"],"path":["direcciones"],"query":[{"key":"id","value":"672592f30bc460c95a73f6c"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"90"},{"key":"ETag","value":"W/\"5a-av4nAMaZeQO+4ICj3HlL+vI07H4\""},{"key":"Set-Cookie","value":"connect.sid=s%3ACARZduwjUlSmYrViyUlXmOtfU3YEWzb6.sbjdAVeh%2FP0PeBp9UF13zI%2B%2F6L4cT5VJtiPq3ulbGiA; Path=/; HttpOnly"},{"key":"Date","value":"Sat, 02 Nov 2024 03:01:36 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"ID no válido. Debe ser un ObjectId de 24 caracteres en formato hexadecimal.\"\n}"},{"id":"cbef9e3c-4146-43c3-abf6-17a653edb2d7","name":"403","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api-envios.appsincode.com/api/v2/direcciones?id=","host":["https://api-envios.appsincode.com/api/v2"],"path":["direcciones"],"query":[{"key":"id","value":"","description":"(obligatorio)"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"63"},{"key":"ETag","value":"W/\"3f-JsOakNwmFGGWce6cMQ3G34heark\""},{"key":"Set-Cookie","value":"connect.sid=s%3AkxXWy87YKxun16Q5Yec-CqljnkxAOFUX.nxttLJnLXzTIK0GqM6%2BW5mDjAGGsgh9RRun15xdaUa4; Path=/; HttpOnly"},{"key":"Date","value":"Sun, 03 Nov 2024 22:19:16 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"No tienes permiso para acceder a esta dirección.\"\n}"},{"id":"2619137a-e55b-4791-aea4-5ea14e3b2ace","name":"404","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api-envios.appsincode.com/api/v2/direcciones?id=672592f30bc460c95a73f6c7","host":["https://api-envios.appsincode.com/api/v2"],"path":["direcciones"],"query":[{"key":"id","value":"672592f30bc460c95a73f6c7"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"73"},{"key":"ETag","value":"W/\"49-1ooB2n7F8aKxyWseonIqxaKqn7w\""},{"key":"Date","value":"Sat, 02 Nov 2024 03:01:56 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Dirección no encontrada con el ID 672592f30bc460c95a73f6c7\"\n}"}],"_postman_id":"8b441945-fe6d-4f97-88ba-891313f349d1"},{"name":"Listar Direcciones","id":"385f0ded-418f-4ed4-98a1-bd7b94a2fbe5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"https://api-envios.appsincode.com/api/v2/direcciones","description":"

Listar direcciones

Este endpoint permite obtener una lista de todas las direcciones asociadas al usuario autenticado.

URL

/direcciones

Método

GET

Headers

Authorization: {{token}}

Descripción

Si no se proporciona un parámetro id, el endpoint devuelve todas las direcciones asociadas al usuario autenticado basado en el userId de la sesión.

Ejemplo de Solicitud

GET /direcciones\n\n

Respuestas

Respuesta Exitosa (200 OK)

Devuelve un arreglo de objetos con todas las direcciones del usuario.

[ { \"_id\": \"60c72b2f9b1e8e5d88d2a48e\", \"cp\": \"12345\", \"colonia\": \"Centro\", \"ciudad\": \"Ciudad de México\", \"estado\": \"Ciudad de México\", \"users\": \"id_del_usuario\", \"otros_campos\": \"Valores adicionales\" }, ...]

Errores Comunes

{ \"message\": \"No se encontraron direcciones para el usuario.\"}
\n
{ \"message\": \"Error al obtener la dirección o direcciones.\"}
\n

Logs Generados

Información (INFO): Cuando se recibe una solicitud para obtener todas las direcciones del usuario.
\n
Advertencia (WARN): Cuando no se encuentran direcciones para el usuario.
\n
Error (ERROR): Cuando ocurre un error en el servidor durante la obtención de las direcciones del usuario.
\n

\n","urlObject":{"path":["direcciones"],"host":["https://api-envios.appsincode.com/api/v2"],"query":[],"variable":[]}},"response":[{"id":"31497e73-f18a-4da1-b1c8-38e188aaf2ae","name":"200","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api-envios.appsincode.com/api/v2/direcciones?id=672592f30bc460c95a73f6c6","host":["https://api-envios.appsincode.com/api/v2"],"path":["direcciones"],"query":[{"key":"id","value":"672592f30bc460c95a73f6c6","type":"text"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"472"},{"key":"ETag","value":"W/\"1d8-sCUMZiHXJ7JuHZYSYC2bIgTAtM8\""},{"key":"Set-Cookie","value":"connect.sid=s%3A-zBjsJV-4ER-Uh76zQKx6xDInlS4qZAJ.yUfuBI6A%2BZu06cXS43sWurjJ43Fc0aT7lGUR4HKbn%2BQ; Path=/; HttpOnly"},{"key":"Date","value":"Sat, 02 Nov 2024 03:00:08 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"estado\": \"Ciudad de México\",\n \"colonia\": \"Centro (Área 6)\",\n \"nombre\": \"Juan Pérez\",\n \"email\": \"juan.perez@example.com\",\n \"telefono\": \"5512345678\",\n \"empresa\": \"Empresa Ejemplo S.A.\",\n \"rfc\": \"ABC123456789\",\n \"calle\": \"Av. Insurgentes\",\n \"numero\": \"123\",\n \"referencia\": \"Cerca del parque\",\n \"alias\": \"Casa Principal\",\n \"users\": \"672545a62df2f608d5f5dc88\",\n \"createdAt\": \"2024-11-02T02:48:19.076Z\",\n \"updatedAt\": \"2024-11-02T02:48:19.076Z\",\n \"id\": \"672592f30bc460c95a73f6c6\"\n}"},{"id":"30f29364-2899-4784-b810-e9b589febea3","name":"400","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api-envios.appsincode.com/api/v2/direcciones?id=672592f30bc460c95a73f6c","host":["https://api-envios.appsincode.com/api/v2"],"path":["direcciones"],"query":[{"key":"id","value":"672592f30bc460c95a73f6c"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"90"},{"key":"ETag","value":"W/\"5a-av4nAMaZeQO+4ICj3HlL+vI07H4\""},{"key":"Set-Cookie","value":"connect.sid=s%3ACARZduwjUlSmYrViyUlXmOtfU3YEWzb6.sbjdAVeh%2FP0PeBp9UF13zI%2B%2F6L4cT5VJtiPq3ulbGiA; Path=/; HttpOnly"},{"key":"Date","value":"Sat, 02 Nov 2024 03:01:36 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"ID no válido. Debe ser un ObjectId de 24 caracteres en formato hexadecimal.\"\n}"},{"id":"a4f19d18-d41a-42d4-a585-e754b6a93178","name":"404","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api-envios.appsincode.com/api/v2/direcciones?id=672592f30bc460c95a73f6c7","host":["https://api-envios.appsincode.com/api/v2"],"path":["direcciones"],"query":[{"key":"id","value":"672592f30bc460c95a73f6c7"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"73"},{"key":"ETag","value":"W/\"49-1ooB2n7F8aKxyWseonIqxaKqn7w\""},{"key":"Date","value":"Sat, 02 Nov 2024 03:01:56 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Dirección no encontrada con el ID 672592f30bc460c95a73f6c7\"\n}"}],"_postman_id":"385f0ded-418f-4ed4-98a1-bd7b94a2fbe5"}],"id":"398208c7-70fd-4636-8419-cad0e61385b4","_postman_id":"398208c7-70fd-4636-8419-cad0e61385b4","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"d470d245-9dd4-4af5-9ae4-55100fd71b7a","id":"d470d245-9dd4-4af5-9ae4-55100fd71b7a","name":"Envios API","type":"collection"}}},{"name":"Colonias","item":[{"name":"Colonias por CP","id":"eff27b62-290a-4b64-af3c-70f699886b4e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"https://api-envios.appsincode.com/api/v2/colonias?cp=","description":"

Consultar colonias

Este endpoint permite obtener una lista de colonias asociadas a un código postal específico en México.

Endpoint

/colonias?cp={codigo_postal}

Método

GET

Headers

Authorization: {{token}}

Parámetros de Consulta

cp (string): Código postal de 5 dígitos para el cual se desea obtener las colonias.

Ejemplo de Solicitud

plaintext

GET /colonias?cp=12345\n\n

Respuestas

Respuesta Exitosa (200 OK)

Devuelve un arreglo de objetos con información sobre las colonias.

[ { \"colonia\": \"Nombre de la Colonia\", \"cp\": \"12345\", \"estado\": \"Nombre del Estado\", \"ciudad\": \"Nombre de la Ciudad\" }, ...]

Errores Comunes

{ \"message\": \"Código postal no válido. Debe ser un número de 5 dígitos.\"}
\n
{ \"message\": \"No se encontraron colonias para el código postal proporcionado.\"}
\n
{ \"message\": \"Error al obtener las colonias.\"}
\n

Ejemplo de Respuesta Exitosa

View Morejson

[\n  {\n    \"colonia\": \"Centro\",\n    \"cp\": \"12345\",\n    \"estado\": \"Ciudad de México\",\n    \"ciudad\": \"Ciudad de México\"\n  },\n  {\n    \"colonia\": \"Chapultepec\",\n    \"cp\": \"12345\",\n    \"estado\": \"Ciudad de México\",\n    \"ciudad\": \"Ciudad de México\"\n  }\n]\n\n

Logs Generados

Advertencia (WARN): Cuando el código postal no es válido.
\n
Información (INFO): Cuando se recibe una solicitud para obtener colonias.
\n
Error (ERROR): Cuando no se encuentran datos de colonias o cuando ocurre un error en la solicitud.
\n

\n","urlObject":{"path":["colonias"],"host":["https://api-envios.appsincode.com/api/v2"],"query":[{"description":{"content":"

(obligatorio)

\n","type":"text/plain"},"key":"cp","value":""}],"variable":[]}},"response":[{"id":"6ae85b9d-4005-416f-8d55-75ef174eaba4","name":"200","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api-envios.appsincode.com/api/v2/colonias?cp=","host":["https://api-envios.appsincode.com/api/v2"],"path":["colonias"],"query":[{"key":"cp","value":"","description":"(obligatorio)"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"0"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"RateLimit-Policy","value":"100;w=900"},{"key":"RateLimit-Limit","value":"100"},{"key":"RateLimit-Remaining","value":"98"},{"key":"RateLimit-Reset","value":"871"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"268"},{"key":"ETag","value":"W/\"10c-mAKRofRTWCQVxqGCVmk4AhNiqlw\""},{"key":"Date","value":"Wed, 20 Aug 2025 23:13:52 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"colonia\": \"Fidel Velázquez\",\n \"cp\": \"97166\",\n \"estado\": \"Yucatán\",\n \"ciudad\": \"Mérida\"\n },\n {\n \"colonia\": \"Salvador Alvarado Oriente\",\n \"cp\": \"97166\",\n \"estado\": \"Yucatán\",\n \"ciudad\": \"Mérida\"\n },\n {\n \"colonia\": \"Fidel Velázquez 2a Etapa\",\n \"cp\": \"97166\",\n \"estado\": \"Yucatán\",\n \"ciudad\": \"Mérida\"\n }\n]"},{"id":"3a08c306-401e-4973-a436-d7a35f12a785","name":"400","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api-envios.appsincode.com/api/v2/colonias?cp=","host":["https://api-envios.appsincode.com/api/v2"],"path":["colonias"],"query":[{"key":"cp","value":"","description":"(obligatorio)"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":null,"header":[{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"0"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"RateLimit-Policy","value":"100;w=900"},{"key":"RateLimit-Limit","value":"100"},{"key":"RateLimit-Remaining","value":"96"},{"key":"RateLimit-Reset","value":"819"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"164"},{"key":"ETag","value":"W/\"a4-CKDqDgOaxCWCFJ6NXRSi1H/ZqD8\""},{"key":"Date","value":"Wed, 20 Aug 2025 23:14:44 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Validación fallida\",\n \"details\": [\n {\n \"message\": \"\\\"query.cp\\\" with value \\\"971665\\\" fails to match the required pattern: /^\\\\d{5}$/\",\n \"path\": [\n \"query\",\n \"cp\"\n ]\n }\n ]\n}"}],"_postman_id":"eff27b62-290a-4b64-af3c-70f699886b4e"}],"id":"576a45e5-f42c-4cc2-a9a3-7288f8f505f4","description":"

Colonias

\n","_postman_id":"576a45e5-f42c-4cc2-a9a3-7288f8f505f4","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"d470d245-9dd4-4af5-9ae4-55100fd71b7a","id":"d470d245-9dd4-4af5-9ae4-55100fd71b7a","name":"Envios API","type":"collection"}}},{"name":"Envios","item":[{"name":"Cotizar envio","id":"6589fd4b-099e-4313-988e-050ee22fb72c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"origen\": \"06060\", // (obligatorio)\r\n \"destino\": \"06060\", // (obligatorio)\r\n \"peso\": \"1\", // (obligatorio)\r\n \"largo\": \"10\", // (obligatorio)\r\n \"alto\": \"10\", // (obligatorio)\r\n \"ancho\": \"10\" // (obligatorio)\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-envios.appsincode.com/api/v2/cotizar","description":"

Cotización de Envío

Este endpoint permite realizar una cotización de envío según los detalles proporcionados, como origen, destino y dimensiones del paquete.

Limite de Solicitudes

El Sistema permite solicitudes concurrentes para la cotizacion de los servicios, sin embargo para no saturar los servicios hay un limite de 100 solicitudes por minuto para cada usuario, en caso de requerir que se aumenten estas solicitudes favor de solicitarlo al administrador de la plataforma para evaluar el caso de uso y si es viable permitir el aumento de solicitudes.

URL

/cotizar

Método

POST

Headers

Authorization: {{token}}

Cuerpo de la Solicitud (JSON)

origen (string): Código postal o ubicación de origen del envío.
\n
destino (string): Código postal o ubicación de destino del envío.
\n
peso (string): Peso del paquete en kilogramos.
\n
largo (string): Largo del paquete en centímetros.
\n
alto (string): Alto del paquete en centímetros.
\n
ancho (string): Ancho del paquete en centímetros.
\n

Ejemplo de Solicitud

{\n    \"origen\": \"06060\", // (obligatorio)\n    \"destino\": \"06060\", // (obligatorio)\n    \"peso\": \"1\", // (obligatorio)\n    \"largo\": \"10\", // (obligatorio)\n    \"alto\": \"10\", // (obligatorio)\n    \"ancho\": \"10\" // (obligatorio)\n}\n\n

Validaciones

Parámetros de la Solicitud: Todos los campos (origen, destino, peso, largo, alto, ancho) son obligatorios. Si alguno falta, se devolverá un error.
\n
Usuario Autenticado: Verifica que el usuario autenticado exista en la base de datos. Si no existe, devuelve un error.
\n

Respuestas

Respuesta Exitosa (200 OK)

Devuelve un arreglo de objetos con las opciones de servicios de envío disponibles y sus costos.

[\n    {\n        \"id\": \"7d02334d-173b-4bde-9a37-0e87aec520d0\",\n        \"servicio\": \"UPS Nacional (mejor precio 1 a 5 kgs.)\",\n        \"total\": 393.88\n    },\n    {\n        \"id\": \"0b12ebba-4b0e-43b9-bae6-ece5f145bd30\",\n        \"servicio\": \"DHL Express aereo (mejor precio 1 - 8kgs.)\",\n        \"total\": 365.55\n    },\n    {\n        \"id\": \"d7417cf0-73bf-477b-91a4-0ec0a27fc799\",\n        \"servicio\": \"DHL Economy Select (mejor precio 1-8kgs.)\",\n        \"total\": 365.55\n    },\n    {\n        \"id\": \"29f242fd-7978-4db9-bea4-114109de39f3\",\n        \"servicio\": \"DHL Domestic Express \\\"1\",\n        \"total\": 275.05\n    },\n    {\n        \"id\": \"7a8d1c38-e075-4e89-9bb1-dcf43f762d5d\",\n        \"servicio\": \"DHL Domestic \\\"\",\n        \"total\": 275.05\n    },\n    {\n        \"id\": \"12d9748b-f804-455b-a8b5-dd5da43bb18b\",\n        \"servicio\": \"DHL EXPRESS seguridad (con seguro directo de 3000 pesos por robo total)\",\n        \"total\": 387.25\n    },\n    {\n        \"id\": \"7a5972c6-a204-45cd-b012-9b5e0b18787d\",\n        \"servicio\": \"Estafeta Terrestre Express 1\",\n        \"total\": 347.32\n    },\n    {\n        \"id\": \"b1438ceb-60cc-449f-b4d0-e00d0456a33c\",\n        \"servicio\": \"Estafeta Aeroexpress 1\",\n        \"total\": 887.26\n    },\n    {\n        \"id\": \"14039aa3-f06e-4bed-b651-7efa059014c7\",\n        \"servicio\": \"PAQUETEXPRESS 24 horas (con seguro directo de $10,000mxn por robo)\",\n        \"total\": 480.08\n    },\n    {\n        \"id\": \"e958fcff-8a1b-417d-991b-a475d10176c8\",\n        \"servicio\": \"Paquetexpress / la cobertura se valida al generar la guia\",\n        \"total\": 267.99\n    },\n    {\n        \"id\": \"00353885-f4b5-416d-989e-ae5a8944a30e\",\n        \"servicio\": \"PAQUETEXPRESS 24 horas (con seguro directo de $5000mxn por robo)\",\n        \"total\": 365.08\n    },\n    {\n        \"id\": \"58d09b12-a41d-4d4f-8df8-a19501da4a76\",\n        \"servicio\": \"Paquetexpress el mejor servicio\",\n        \"total\": 255.08\n    },\n    {\n        \"id\": \"4bd4c3b3-8d22-42db-9bf7-45584b9e8c98\",\n        \"servicio\": \"SENDEX promocion 55 kilos Dia siguiente http://www.sendex.mx/Recoleccion/Recoleccion\",\n        \"total\": 140\n    },\n    {\n        \"id\": \"502767b9-4e1d-473f-9d6c-82e90022aa57\",\n        \"servicio\": \"ATENCION precios de alegria sendex ;)\",\n        \"total\": 165\n    },\n    {\n        \"id\": \"088e9c93-8c9a-4621-92de-e4907070b8dd\",\n        \"servicio\": \"AM-PM /mejor precio de 1 a 10 kilos\",\n        \"total\": 210.97\n    },\n    {\n        \"id\": \"3f0792b5-37da-485d-bb43-de11a3df844c\",\n        \"servicio\": \"FedEx NACIONAL KILOS GRANDES\",\n        \"total\": 634.1\n    },\n    {\n        \"id\": \"5b70b20c-a25a-4ef1-b184-013547c484a7\",\n        \"servicio\": \"FedEx Servicio Dia Siguiente\",\n        \"total\": 512.59\n    },\n    {\n        \"id\": \"eb8605bf-fce8-4833-9c5d-a50600939003\",\n        \"servicio\": \"FedEx Nacional Terrestre Elite Constructora\",\n        \"total\": 532.98\n    }\n]\n\n

Errores Comunes

400 Bad Request:
\n
- { \"message\": \"Todos los campos (origen, destino, peso, largo, alto, ancho) son obligatorios.\"}
\n
404 Not Found:
\n
- { \"message\": \"Usuario no encontrado.\"}
  \n
- { \"message\": \"No se encontraron servicios de cotización para los parámetros proporcionados.\"}
  \n
- { \"message\": \"Error al obtener los servicios de envío.\"}
  \n
\n
403 Too Many Request
\n
- {\"message\": \"Has alcanzado el límite de solicitudes permitidas. Intenta más tarde.\"}
\n

Logs Generados

Advertencia (WARN): Cuando los parámetros de la solicitud están incompletos, el usuario no existe o no se encuentran servicios de cotización.
\n
Información (INFO): Cuando se recibe una solicitud de cotización de envío y cuando los servicios de cotización se obtienen exitosamente.
\n
Error (ERROR): Cuando ocurre un error en el servidor durante la obtención de la cotización de servicios de envío.
\n

\n","urlObject":{"path":["cotizar"],"host":["https://api-envios.appsincode.com/api/v2"],"query":[],"variable":[]}},"response":[{"id":"acc1ec47-bced-4ac5-83a9-62019abe2d69","name":"200 - Solicitud Exitosa","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"origen\": \"06060\",\r\n \"destino\": \"06060\",\r\n \"peso\": \"20\",\r\n \"largo\": \"10\",\r\n \"alto\": \"10\",\r\n \"ancho\": \"10\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-envios.appsincode.com/api/v2/cotizar"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"2098"},{"key":"ETag","value":"W/\"832-dkMrUZ1CtUgzIhg3ZadVfaUboVo\""},{"key":"Set-Cookie","value":"connect.sid=s%3AgkX_3IEnv_HvneVt_x86ENvqNkBX6PRs.nUebpjHQ8C%2BFph44wYwowUctvh15Wuc%2BAC5sbzm0pJE; Path=/; HttpOnly"},{"key":"Date","value":"Sat, 02 Nov 2024 22:55:28 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"7d02334d-173b-4bde-9a37-0e87aec520d0\",\n \"servicio\": \"UPS Nacional (mejor precio 1 a 5 kgs.)\",\n \"total\": 393.88\n },\n {\n \"id\": \"0b12ebba-4b0e-43b9-bae6-ece5f145bd30\",\n \"servicio\": \"DHL Express aereo (mejor precio 1 - 8kgs.)\",\n \"total\": 365.55\n },\n {\n \"id\": \"d7417cf0-73bf-477b-91a4-0ec0a27fc799\",\n \"servicio\": \"DHL Economy Select (mejor precio 1-8kgs.)\",\n \"total\": 365.55\n },\n {\n \"id\": \"29f242fd-7978-4db9-bea4-114109de39f3\",\n \"servicio\": \"DHL Domestic Express \\\"1\",\n \"total\": 275.05\n },\n {\n \"id\": \"7a8d1c38-e075-4e89-9bb1-dcf43f762d5d\",\n \"servicio\": \"DHL Domestic \\\"\",\n \"total\": 275.05\n },\n {\n \"id\": \"12d9748b-f804-455b-a8b5-dd5da43bb18b\",\n \"servicio\": \"DHL EXPRESS seguridad (con seguro directo de 3000 pesos por robo total)\",\n \"total\": 387.25\n },\n {\n \"id\": \"7a5972c6-a204-45cd-b012-9b5e0b18787d\",\n \"servicio\": \"Estafeta Terrestre Express 1\",\n \"total\": 347.32\n },\n {\n \"id\": \"b1438ceb-60cc-449f-b4d0-e00d0456a33c\",\n \"servicio\": \"Estafeta Aeroexpress 1\",\n \"total\": 887.26\n },\n {\n \"id\": \"14039aa3-f06e-4bed-b651-7efa059014c7\",\n \"servicio\": \"PAQUETEXPRESS 24 horas (con seguro directo de $10,000mxn por robo)\",\n \"total\": 480.08\n },\n {\n \"id\": \"e958fcff-8a1b-417d-991b-a475d10176c8\",\n \"servicio\": \"Paquetexpress / la cobertura se valida al generar la guia\",\n \"total\": 267.99\n },\n {\n \"id\": \"00353885-f4b5-416d-989e-ae5a8944a30e\",\n \"servicio\": \"PAQUETEXPRESS 24 horas (con seguro directo de $5000mxn por robo)\",\n \"total\": 365.08\n },\n {\n \"id\": \"58d09b12-a41d-4d4f-8df8-a19501da4a76\",\n \"servicio\": \"Paquetexpress el mejor servicio\",\n \"total\": 255.08\n },\n {\n \"id\": \"4bd4c3b3-8d22-42db-9bf7-45584b9e8c98\",\n \"servicio\": \"SENDEX promocion 55 kilos Dia siguiente http://www.sendex.mx/Recoleccion/Recoleccion\",\n \"total\": 140\n },\n {\n \"id\": \"502767b9-4e1d-473f-9d6c-82e90022aa57\",\n \"servicio\": \"ATENCION precios de alegria sendex ;)\",\n \"total\": 165\n },\n {\n \"id\": \"088e9c93-8c9a-4621-92de-e4907070b8dd\",\n \"servicio\": \"AM-PM /mejor precio de 1 a 10 kilos\",\n \"total\": 210.97\n },\n {\n \"id\": \"3f0792b5-37da-485d-bb43-de11a3df844c\",\n \"servicio\": \"FedEx NACIONAL KILOS GRANDES\",\n \"total\": 634.1\n },\n {\n \"id\": \"5b70b20c-a25a-4ef1-b184-013547c484a7\",\n \"servicio\": \"FedEx Servicio Dia Siguiente\",\n \"total\": 512.59\n },\n {\n \"id\": \"eb8605bf-fce8-4833-9c5d-a50600939003\",\n \"servicio\": \"FedEx Nacional Terrestre Elite Constructora\",\n \"total\": 532.98\n }\n]"},{"id":"f6587f0d-12e8-47e2-85d3-8e0f32e17cde","name":"400 Error de Validacion","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-envios.appsincode.com/api/v2/cotizar"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"92"},{"key":"ETag","value":"W/\"5c-2C1JBwx3hC58NohLJBtWO1cgjlM\""},{"key":"Date","value":"Sat, 02 Nov 2024 22:58:37 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Todos los campos (origen, destino, peso, largo, alto, ancho) son obligatorios.\"\n}"},{"id":"fe789b05-d214-4fc4-af3d-f12e19bcff13","name":"403 - Demasiadas Solicitudes","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"origen\": \"06060\", // (obligatorio)\r\n \"destino\": \"06060\", // (obligatorio)\r\n \"peso\": \"1\", // (obligatorio)\r\n \"largo\": \"10\", // (obligatorio)\r\n \"alto\": \"10\", // (obligatorio)\r\n \"ancho\": \"10\" // (obligatorio)\r\n}","options":{"raw":{"language":"json"}}},"url":"{{URL_dev}}/cotizar"},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"X-RateLimit-Limit","value":"10"},{"key":"X-RateLimit-Remaining","value":"7"},{"key":"Date","value":"Sat, 01 Mar 2025 05:51:40 GMT"},{"key":"X-RateLimit-Reset","value":"1740808318"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"85"},{"key":"ETag","value":"W/\"55-dToUsvb+7oT1Ho+AtfBnXpBu/NM\""},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Has alcanzado el límite de solicitudes permitidas. Intenta más tarde.\"\n}"}],"_postman_id":"6589fd4b-099e-4313-988e-050ee22fb72c"},{"name":"Crear Envio","id":"b353a3e9-0ba4-40b4-92ec-133e47780f70","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"origen_alias\": \"alias-origen\", // Obligatorio\r\n \"destino_alias\": \"alias-destino\", //Obligatorio\r\n \"peso\": \"1\", //Obligatorio\r\n \"largo\": \"10\", //Obligatorio\r\n \"alto\": \"10\", //Obligatorio\r\n \"ancho\": \"10\", //Obligatorio\r\n \"sat_id\": \"53102902\", //Obligatorio\r\n \"contenido\": \"Ropa\", //Obligatorio\r\n \"servicio_id\": \"0a2eb95a-b908-4970-ab20-f75193679afa\", //Obligatorio\r\n \"cantidad_guias\": \"1\" //Obligatorio\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://api-envios.appsincode.com/api/v2/envio","description":"

Crear Envío y Generar Etiqueta

Este endpoint permite crear un envío y generar una etiqueta según los detalles proporcionados, incluyendo la verificación de dirección, servicio y saldo disponible.

URL

/envio

Método

POST

Headers

Authorization: {{token}}

Cuerpo de la Solicitud (JSON)

origen_alias (string): Alias de la dirección de origen del envío.
\n
destino_alias (string): Alias de la dirección de destino del envío.
\n
peso (number): Peso del paquete en kilogramos.
\n
largo (number): Largo del paquete en centímetros.
\n
alto (number): Alto del paquete en centímetros.
\n
ancho (number): Ancho del paquete en centímetros.
\n
sat_id (string): ID del producto según el catálogo SAT.
\n
contenido (string): Descripción del contenido del paquete.
\n
servicio_id (string): ID del servicio de envío seleccionado.
\n
cantidad_guias (number, opcional): Número de guías que se requieren para el envío (por defecto es 1).
\n

Ejemplo de Solicitud

{\n    \"origen_alias\": \"alias-origen\", // Obligatorio\n    \"destino_alias\": \"alias-destino\", //Obligatorio\n    \"peso\": \"1\", //Obligatorio\n    \"largo\": \"20\", //Obligatorio\n    \"alto\": \"10\", //Obligatorio\n    \"ancho\": \"10\", //Obligatorio\n    \"sat_id\": \"53102902\", //Obligatorio\n    \"contenido\": \"Ropa\", //Obligatorio\n    \"servicio_id\": \"85d435e6-0ca2-47fb-ae33-aa62684ec7d4\", //Obligatorio\n    \"cantidad_guias\": \"1\" //Obligatorio\n}\n\n

Validaciones

Campos Requeridos: Todos los campos especificados son obligatorios, excepto cantidad_guias.
\n
Direcciones: Verifica que las direcciones de origen y destino existan y estén asociadas al usuario autenticado.
\n
Servicio: Verifica que el servicio_id esté disponible para el envío solicitado.
\n
Saldo Disponible: Verifica que el saldo del usuario cubra el costo total del envío solicitado (basado en cantidad_guias).
\n

Respuestas

Respuesta Exitosa (200 OK)

Devuelve la información del envío y las guías generadas.

{\n    \"origen\": {\n        \"cp\": \"06060\",\n        \"ciudad\": \"Cuauhtémoc\",\n        \"estado\": \"Ciudad de México\",\n        \"colonia\": \"Centro (Área 6)\",\n        \"nombre\": \"Juan Pérez\",\n        \"email\": \"juan.perez@example.com\",\n        \"telefono\": \"5512345678\",\n        \"empresa\": \"Empresa Ejemplo S.A.\",\n        \"rfc\": \"ABC123456789\",\n        \"calle\": \"Av. Insurgentes\",\n        \"numero\": \"123\",\n        \"referencia\": \"Cerca del parque\",\n        \"alias\": \"Casa Principal\",\n        \"users\": \"672545a62df2f608d5f5dc88\",\n        \"createdAt\": \"2024-11-02T02:48:19.076Z\",\n        \"updatedAt\": \"2024-11-02T02:48:19.076Z\",\n        \"id\": \"672592f30bc460c95a73f6c6\"\n    },\n    \"destino\": {\n        \"cp\": \"06060\",\n        \"ciudad\": \"Cuauhtémoc\",\n        \"estado\": \"Ciudad de México\",\n        \"colonia\": \"Centro (Área 6)\",\n        \"nombre\": \"Juan Pérez\",\n        \"email\": \"juan.perez@example.com\",\n        \"telefono\": \"5512345678\",\n        \"empresa\": \"Empresa Ejemplo S.A.\",\n        \"rfc\": \"ABC123456789\",\n        \"calle\": \"Av. Insurgentes\",\n        \"numero\": \"123\",\n        \"referencia\": \"Cerca del parque\",\n        \"alias\": \"Casa Principal\",\n        \"users\": \"672545a62df2f608d5f5dc88\",\n        \"createdAt\": \"2024-11-02T02:48:19.076Z\",\n        \"updatedAt\": \"2024-11-02T02:48:19.076Z\",\n        \"id\": \"672592f30bc460c95a73f6c6\"\n    },\n    \"envio\": [\n        {\n            \"envio_id\": \"a8d52f39-9962-4301-8875-192e8859e341\",\n            \"servicio\": \"FedEx Nacional Terrestre Elite Constructora\",\n            \"costo\": \"116.37\",\n            \"guia\": \"779701971028\"\n        }\n    ],\n    \"guias\": [\n        {\n            \"origen\": \"06060\",\n            \"destino\": \"06060\",\n            \"remitente\": \"Juan Pérez\",\n            \"destinatario\": \"Juan Pérez\",\n            \"numero_guia\": \"779701971028\",\n            \"url\": \"https://6dfb173c-ee1e-4b44-a0b8-cfe67c3bef34.s3.us-west-2.amazonaws.com/uploads/label/file/cc2fc339-d046-40e9-adb3-853b0e920710/a8d52f39-9962-4301-8875-192e8859e341-fedex-nacional-terrestre-elite-constructora.pdf\"\n        }\n    ]\n}\n\n

Errores Comunes

400 Bad Request: Cuando faltan campos requeridos o no se cumplen validaciones.
\n
- { \"errores\": [ { \"campo\": \"origen_alias\", \"mensaje\": \"Este campo es requerido.\" }, { \"campo\": \"peso\", \"mensaje\": \"Este campo es requerido.\" } ]}
  \n
- { \"Error\": \"La dirección de origen no existe.\"}
  \n
- { \"Error\": \"La dirección de destino no existe.\"}
  \n
- { \"Error\": \"El ID del servicio enviado no existe o no está disponible para este envío.\"}
  \n
- { \"Error\": \"Saldo insuficiente para cubrir el costo de los envíos.\", \"saldo_actual\": 150.00, \"cantidad_a_pagar\": 250.00}
  \n
- { \"Error\": \"El ID del producto SAT enviado no existe.\"}
  \n
\n
{ \"Error\": \"Error al crear el envío.\", \"detalle\": \"Detalles del error específico\"}
\n

Logs Generados

Advertencia (WARN): Cuando faltan campos requeridos, alguna dirección no existe, el servicio no está disponible, el saldo es insuficiente, o el producto SAT no existe.
\n
Información (INFO): Cuando la solicitud se procesa exitosamente en cada paso: validación de saldo, creación del envío, adición del paquete, confirmación del envío y obtención de la etiqueta.
\n
Error (ERROR): Cuando ocurre un error en el servidor en cualquier paso del proceso, incluyendo creación de envío, verificación de SAT ID y obtención de la etiqueta.
\n

\n","urlObject":{"path":["envio"],"host":["https://api-envios.appsincode.com/api/v2"],"query":[],"variable":[]}},"response":[{"id":"51d7e863-bb04-43d1-a05e-391ec1667c90","name":"200 - Envio Exitoso","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"origen_alias\": \"Casa Principal\",\r\n \"destino_alias\": \"Casa Principal\",\r\n \"peso\": \"1\",\r\n \"largo\": \"10\",\r\n \"alto\": \"10\",\r\n \"ancho\": \"10\",\r\n \"sat_id\": \"53102301\",\r\n \"contenido\": \"Camisetas\",\r\n \"servicio_id\": \"eb8605bf-fce8-4833-9c5d-a50600939003\",\r\n \"cantidad_guias\": \"1\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-envios.appsincode.com/api/v2/envio"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"1476"},{"key":"ETag","value":"W/\"5c4-yBqrHHNYp4xGrFaEgKGauCB3uD8\""},{"key":"Set-Cookie","value":"connect.sid=s%3AHbFYiVl2APVeiN6-q7Uok03aJDGHwXFH.cPhkOE2y%2Fbu2Bd59QXhiyIBaeOwV0Q30ML%2B3YHLyfWA; Path=/; HttpOnly"},{"key":"Date","value":"Sun, 03 Nov 2024 19:57:48 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"origen\": {\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"estado\": \"Ciudad de México\",\n \"colonia\": \"Centro (Área 6)\",\n \"nombre\": \"Juan Pérez\",\n \"email\": \"juan.perez@example.com\",\n \"telefono\": \"5512345678\",\n \"empresa\": \"Empresa Ejemplo S.A.\",\n \"rfc\": \"ABC123456789\",\n \"calle\": \"Av. Insurgentes\",\n \"numero\": \"123\",\n \"referencia\": \"Cerca del parque\",\n \"alias\": \"Casa Principal\",\n \"users\": \"672545a62df2f608d5f5dc88\",\n \"createdAt\": \"2024-11-02T02:48:19.076Z\",\n \"updatedAt\": \"2024-11-02T02:48:19.076Z\",\n \"id\": \"672592f30bc460c95a73f6c6\"\n },\n \"destino\": {\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"estado\": \"Ciudad de México\",\n \"colonia\": \"Centro (Área 6)\",\n \"nombre\": \"Juan Pérez\",\n \"email\": \"juan.perez@example.com\",\n \"telefono\": \"5512345678\",\n \"empresa\": \"Empresa Ejemplo S.A.\",\n \"rfc\": \"ABC123456789\",\n \"calle\": \"Av. Insurgentes\",\n \"numero\": \"123\",\n \"referencia\": \"Cerca del parque\",\n \"alias\": \"Casa Principal\",\n \"users\": \"672545a62df2f608d5f5dc88\",\n \"createdAt\": \"2024-11-02T02:48:19.076Z\",\n \"updatedAt\": \"2024-11-02T02:48:19.076Z\",\n \"id\": \"672592f30bc460c95a73f6c6\"\n },\n \"envio\": [\n {\n \"envio_id\": \"a8d52f39-9962-4301-8875-192e8859e341\",\n \"servicio\": \"FedEx Nacional Terrestre Elite Constructora\",\n \"costo\": \"116.37\",\n \"guia\": \"779701971028\"\n }\n ],\n \"guias\": [\n {\n \"origen\": \"06060\",\n \"destino\": \"06060\",\n \"remitente\": \"Juan Pérez\",\n \"destinatario\": \"Juan Pérez\",\n \"numero_guia\": \"779701971028\",\n \"url\": \"https://6dfb173c-ee1e-4b44-a0b8-cfe67c3bef34.s3.us-west-2.amazonaws.com/uploads/label/file/cc2fc339-d046-40e9-adb3-853b0e920710/a8d52f39-9962-4301-8875-192e8859e341-fedex-nacional-terrestre-elite-constructora.pdf\"\n }\n ]\n}"},{"id":"a97b2659-9a01-4aae-be75-3ce91d032ec5","name":"400 - Error validaciones","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-envios.appsincode.com/api/v2/envio"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"532"},{"key":"ETag","value":"W/\"214-RX0hDeXD+xeke1Ge6ltqTiYfszQ\""},{"key":"Date","value":"Sun, 03 Nov 2024 02:27:11 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"errores\": [\n {\n \"campo\": \"origen_alias\",\n \"mensaje\": \"Este campo es requerido.\"\n },\n {\n \"campo\": \"destino_alias\",\n \"mensaje\": \"Este campo es requerido.\"\n },\n {\n \"campo\": \"peso\",\n \"mensaje\": \"Este campo es requerido.\"\n },\n {\n \"campo\": \"largo\",\n \"mensaje\": \"Este campo es requerido.\"\n },\n {\n \"campo\": \"alto\",\n \"mensaje\": \"Este campo es requerido.\"\n },\n {\n \"campo\": \"ancho\",\n \"mensaje\": \"Este campo es requerido.\"\n },\n {\n \"campo\": \"sat_id\",\n \"mensaje\": \"Este campo es requerido.\"\n },\n {\n \"campo\": \"contenido\",\n \"mensaje\": \"Este campo es requerido.\"\n },\n {\n \"campo\": \"servicio_id\",\n \"mensaje\": \"Este campo es requerido.\"\n }\n ]\n}"},{"id":"20d466d2-061c-4224-afde-78aef38fe6d4","name":"400 - Error direccion origen","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"origen_alias\": \"Casa Principal1\",\r\n \"destino_alias\": \"Casa Principal1\",\r\n \"peso\": \"1\",\r\n \"largo\": \"10\",\r\n \"alto\": \"10\",\r\n \"ancho\": \"10\",\r\n \"sat_id\": \"53102301\",\r\n \"contenido\": \"Camisetas\",\r\n \"servicio_id\": \"eb8605bf-fce8-4833-9c5d-a50600939003\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-envios.appsincode.com/api/v2/envio"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"46"},{"key":"ETag","value":"W/\"2e-syFIeW0z5RQdAQUxd7N2Kww3IL4\""},{"key":"Date","value":"Sun, 03 Nov 2024 02:28:00 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"Error\": \"La dirección de origen no existe.\"\n}"},{"id":"feacd2c1-560f-4f75-ac85-72174838a8dc","name":"400 - Error direccion destino","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"origen_alias\": \"Casa Principal\",\r\n \"destino_alias\": \"Casa Principal1\",\r\n \"peso\": \"1\",\r\n \"largo\": \"10\",\r\n \"alto\": \"10\",\r\n \"ancho\": \"10\",\r\n \"sat_id\": \"53102301\",\r\n \"contenido\": \"Camisetas\",\r\n \"servicio_id\": \"eb8605bf-fce8-4833-9c5d-a50600939003\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-envios.appsincode.com/api/v2/envio"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"47"},{"key":"ETag","value":"W/\"2f-HAouhywsOPZFI7+bfmlg6QoBNNA\""},{"key":"Date","value":"Sun, 03 Nov 2024 02:29:33 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"Error\": \"La dirección de destino no existe.\"\n}"},{"id":"b55b0c01-f8cb-4611-86d2-938de3129530","name":"400 - Error de servicio_id","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"origen_alias\": \"Casa Principal\",\r\n \"destino_alias\": \"Casa Principal\",\r\n \"peso\": \"1\",\r\n \"largo\": \"10\",\r\n \"alto\": \"10\",\r\n \"ancho\": \"10\",\r\n \"sat_id\": \"53102301\",\r\n \"contenido\": \"Camisetas\",\r\n \"servicio_id\": \"eb8605bf-fce8-4833-9c5d-a50600939004\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-envios.appsincode.com/api/v2/envio"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"88"},{"key":"ETag","value":"W/\"58-eHE2xZWwhnQgIkJsRj2uoyb5Fpk\""},{"key":"Set-Cookie","value":"connect.sid=s%3AJVFb-oLLGcdPtJQGgVcFY6p8uGJAuaFA.7t2jOUzRXefGg0mv13yZl7cW2qnZNeOUgLsyY4uSX9o; Path=/; HttpOnly"},{"key":"Date","value":"Sun, 03 Nov 2024 02:37:09 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"Error\": \"El ID del servicio enviado no existe o no está disponible para este envío.\"\n}"},{"id":"fa4a32aa-7809-4b26-8e71-3b4417d75280","name":"Cre","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"origen_alias\": \"test123456\", // Obligatorio\r\n \"destino_alias\": \"test123456\", //Obligatorio\r\n \"peso\": \"1\", //Obligatorio\r\n \"largo\": \"10\", //Obligatorio\r\n \"alto\": \"10\", //Obligatorio\r\n \"ancho\": \"10\", //Obligatorio\r\n \"sat_id\": \"53102902\", //Obligatorio\r\n \"contenido\": \"Ropa\", //Obligatorio\r\n \"servicio_id\": \"589070f2-254e-4ed2-a5b6-420ad6b988b6\", //Obligatorio\r\n \"cantidad_guias\": \"1\" //Obligatorio\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"{{URL_prod}}/envio"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Thu, 22 May 2025 23:48:41 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"Vary","value":"Accept-Encoding"},{"key":"X-Powered-By","value":"Express"},{"key":"Ratelimit-Policy","value":"100;w=60"},{"key":"Ratelimit-Limit","value":"100"},{"key":"Ratelimit-Remaining","value":"99"},{"key":"Ratelimit-Reset","value":"60"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Etag","value":"W/\"77b-coOGRE38PkVqAI96IdSwO3BP3Qg\""},{"key":"Content-Encoding","value":"gzip"},{"key":"Cf-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=2VjU3JF9B%2FIe7qjqTMI8OI%2BYReek1HjFYWZfKq9%2FXMohN4mUzN3H86mqr40%2BkMTpn1RG2BN%2Bw54S8mEQ22ZchzjN2e9RqgVhqLlHc60pQSBe0oQqIE9twQE%3D\"}]}"},{"key":"Set-Cookie","value":"connect.sid=s%3Aq7Hlhe6YE9AAu4zcUzBnoFok2erLzcH4.jg0VjZcZCgOGorMFnMFDfOqeckcYtsXqndhC3MrgK3w; HttpOnly; Path=/"},{"key":"CF-RAY","value":"9440339b6bb5eaa0-DFW"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"envio_id\": \"682fb7d90a8755224e20f3de\",\n \"origen\": {\n \"_id\": \"682fa9672d2c717f45cc4d01\",\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"estado\": \"Ciudad de México\",\n \"colonia\": \"Centro (Área 6)\",\n \"nombre\": \"Juan Pérez\",\n \"email\": \"juan.perez@example.com\",\n \"telefono\": \"5512345678\",\n \"empresa\": \"Empresa Ejemplo S.A.\",\n \"rfc\": \"ABC123456789\",\n \"calle\": \"Av. Insurgentes\",\n \"numero\": \"123\",\n \"referencia\": \"Referencia \",\n \"alias\": \"test123456\"\n },\n \"destino\": {\n \"_id\": \"682fa9672d2c717f45cc4d01\",\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"estado\": \"Ciudad de México\",\n \"colonia\": \"Centro (Área 6)\",\n \"nombre\": \"Juan Pérez\",\n \"email\": \"juan.perez@example.com\",\n \"telefono\": \"5512345678\",\n \"empresa\": \"Empresa Ejemplo S.A.\",\n \"rfc\": \"ABC123456789\",\n \"calle\": \"Av. Insurgentes\",\n \"numero\": \"123\",\n \"referencia\": \"Referencia \",\n \"alias\": \"test123456\"\n },\n \"envio\": [\n {\n \"indice\": 1,\n \"envio_id\": \"541371b0-8456-4ef4-b526-07c2da4772d7\",\n \"servicio\": \"FEDEX ÚLTIMA MILLA 1-5KGS Huert\",\n \"costo\": 107.14,\n \"guia\": \"881472526640\",\n \"estado\": \"generada\",\n \"url_etiqueta\": \"https://6dfb173c-ee1e-4b44-a0b8-cfe67c3bef34.s3.us-west-2.amazonaws.com/uploads/label/file/fceb43df-cd01-48ac-839c-de011ad3eb14/541371b0-8456-4ef4-b526-07c2da4772d7-fedex-ultima-milla-1-5kgs-huert.pdf\",\n \"fecha_generacion\": \"2025-05-22T23:48:41.835Z\"\n }\n ],\n \"guias\": [\n {\n \"origen\": \"06060\",\n \"destino\": \"06060\",\n \"remitente\": \"Juan Pérez\",\n \"destinatario\": \"Juan Pérez\",\n \"numero_guia\": \"881472526640\",\n \"url\": \"https://6dfb173c-ee1e-4b44-a0b8-cfe67c3bef34.s3.us-west-2.amazonaws.com/uploads/label/file/fceb43df-cd01-48ac-839c-de011ad3eb14/541371b0-8456-4ef4-b526-07c2da4772d7-fedex-ultima-milla-1-5kgs-huert.pdf\",\n \"shipment_id\": \"541371b0-8456-4ef4-b526-07c2da4772d7\"\n }\n ],\n \"resumen\": {\n \"total_solicitadas\": 1,\n \"generadas_exitosamente\": 1,\n \"costo_total\": 107.14,\n \"saldo_restante\": 40.52999999999999,\n \"tiempo_procesamiento\": \"44203ms\",\n \"servicio_utilizado\": {\n \"id\": \"589070f2-254e-4ed2-a5b6-420ad6b988b6\",\n \"nombre\": \"FEDEX ÚLTIMA MILLA 1-5KGS Huert\",\n \"costo_unitario\": 107.14\n },\n \"desde_cache\": false\n }\n}"}],"_postman_id":"b353a3e9-0ba4-40b4-92ec-133e47780f70"},{"name":"Listar Envios","id":"2a115ba1-caad-40ed-8764-88e827328514","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"https://api-envios.appsincode.com/api/v2/envios","description":"

Método: GET

URL: https://api-envios.appsincode.com/api/v2/envio

Descripción:
Este endpoint permite obtener la lista de todos los envíos asociados al usuario autenticado. Es necesario autenticar la solicitud mediante una API Key válida.

Autenticación:
Requiere API Key en el encabezado de la solicitud.

Respuestas:

✔️ 200 OK - Cuando se encuentran envíos:

{\n  \"success\": true,\n  \"message\": \"Envíos encontrados exitosamente.\",\n  \"total\": 3,\n  \"data\": [\n    { \"_id\": \"...\", \"destino\": \"...\", ... },\n    { \"_id\": \"...\", \"destino\": \"...\", ... },\n    ...\n  ],\n  \"durationMs\": 217\n}\n\n

⚠️ 404 Not Found - Cuando no se encuentran resultados:

{\n  \"success\": false,\n  \"message\": \"No se encontraron envíos.\",\n  \"total\": 0,\n  \"durationMs\": 217\n}\n\n

❌ 500 Internal Server Error - Error interno del servidor:

{\n  \"success\": false,\n  \"message\": \"Error interno al procesar la solicitud.\",\n  \"error\": \"Descripción del error\",\n  \"durationMs\": 432\n}\n\n

Notas:

El tiempo de ejecución de la solicitud está expresado en milisegundos (durationMs).
\n
Se recomienda manejar adecuadamente los códigos de estado HTTP para una mejor experiencia de usuario.
\n

\n","urlObject":{"path":["envios"],"host":["https://api-envios.appsincode.com/api/v2"],"query":[],"variable":[]}},"response":[{"id":"88bd04d1-7c1a-4b8a-8382-9361a06e48ec","name":"404 - No se encontraron envios","originalRequest":{"method":"GET","header":[],"url":"/envio"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"RateLimit-Policy","value":"100;w=60"},{"key":"RateLimit-Limit","value":"100"},{"key":"RateLimit-Remaining","value":"98"},{"key":"RateLimit-Reset","value":"2"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"83"},{"key":"ETag","value":"W/\"53-Ek4nNKEOdqrIbUTbmtqEDTBLsSk\""},{"key":"Date","value":"Tue, 27 May 2025 21:05:40 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"No se encontraron envíos.\",\n \"total\": 0,\n \"durationMs\": 217\n}"},{"id":"445789e3-557f-4d13-b8aa-bae6dbbbf33e","name":"200","originalRequest":{"method":"GET","header":[],"url":"https://api-envios.appsincode.com/api/v2/envios"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Content-Security-Policy","value":"default-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests"},{"key":"Cross-Origin-Opener-Policy","value":"same-origin"},{"key":"Cross-Origin-Resource-Policy","value":"same-origin"},{"key":"Origin-Agent-Cluster","value":"?1"},{"key":"Referrer-Policy","value":"no-referrer"},{"key":"Strict-Transport-Security","value":"max-age=15552000; includeSubDomains"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-DNS-Prefetch-Control","value":"off"},{"key":"X-Download-Options","value":"noopen"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-Permitted-Cross-Domain-Policies","value":"none"},{"key":"X-XSS-Protection","value":"0"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"RateLimit-Policy","value":"100;w=900"},{"key":"RateLimit-Limit","value":"100"},{"key":"RateLimit-Remaining","value":"95"},{"key":"RateLimit-Reset","value":"559"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"14564"},{"key":"ETag","value":"W/\"38e4-DaGkZMQ2tU5nVCg5ZQiw4SA5ct8\""},{"key":"Date","value":"Thu, 21 Aug 2025 19:51:01 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": \"68a762d38ad137953a5826e9\",\n \"origen\": {\n \"alias\": \"alias-origen\",\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"nombre\": \"Juan Pérez\",\n \"estado\": \"Ciudad de México\",\n \"colonia\": \"Centro (Área 6)\",\n \"email\": \"juan.perez@example.com\",\n \"telefono\": \"5512345678\",\n \"empresa\": \"Empresa Ejemplo S.A.\",\n \"rfc\": \"ABC123456789\",\n \"calle\": \"Av. Insurgentes\",\n \"numero\": \"123\",\n \"referencia\": \"Referencia\"\n },\n \"destino\": {\n \"alias\": \"alias-destino\",\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"nombre\": \"Juan Pérez\",\n \"estado\": \"Ciudad de México\",\n \"colonia\": \"Centro (Área 6)\",\n \"email\": \"juan.perez@example.com\",\n \"telefono\": \"5512345678\",\n \"empresa\": \"Empresa Ejemplo S.A.\",\n \"rfc\": \"ABC123456789\",\n \"calle\": \"Av. Insurgentes\",\n \"numero\": \"123\",\n \"referencia\": \"Referencia\"\n },\n \"estado\": \"completo\",\n \"resumen\": {\n \"total_solicitadas\": 1,\n \"exitosas\": 1,\n \"fallidas\": 0,\n \"costo_total\": 146.85,\n \"fecha_procesamiento\": \"2025-08-21T18:17:55.045Z\",\n \"tiempo_procesamiento\": 14145\n },\n \"createdAt\": \"2025-08-21T18:17:55.051Z\",\n \"updatedAt\": \"2025-08-21T18:17:55.051Z\",\n \"guias\": [\n {\n \"numero_guia\": \"883757414655\",\n \"url\": \"https://6dfb173c-ee1e-4b44-a0b8-cfe67c3bef34.s3.us-west-2.amazonaws.com/uploads/label/file/dd78d8c1-5dc6-4ebe-a27c-9215b0de20c0/e58c002f-4bf0-4b75-82c9-ebda34e99c68-fedex-terrestre-cl.pdf\",\n \"shipment_id\": \"e58c002f-4bf0-4b75-82c9-ebda34e99c68\",\n \"parcel_id\": \"67e7e6a4-415c-4394-8268-91fd4f4c8e94\"\n }\n ],\n \"envio\": [\n {\n \"indice\": 1,\n \"envio_id\": \"e58c002f-4bf0-4b75-82c9-ebda34e99c68\",\n \"servicio\": \"FedEx Terrestre cl\",\n \"costo\": 146.85,\n \"guia\": \"883757414655\",\n \"estado\": \"generada\",\n \"url_etiqueta\": \"https://6dfb173c-ee1e-4b44-a0b8-cfe67c3bef34.s3.us-west-2.amazonaws.com/uploads/label/file/dd78d8c1-5dc6-4ebe-a27c-9215b0de20c0/e58c002f-4bf0-4b75-82c9-ebda34e99c68-fedex-terrestre-cl.pdf\",\n \"fecha_generacion\": \"2025-08-21T18:17:55.045Z\"\n }\n ]\n },\n {\n \"id\": \"68a75f9370f8a1813f9754da\",\n \"origen\": {\n \"alias\": \"alias-origen\",\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"nombre\": \"Juan Pérez\",\n \"estado\": \"Ciudad de México\",\n \"colonia\": \"Centro (Área 6)\",\n \"email\": \"juan.perez@example.com\",\n \"telefono\": \"5512345678\",\n \"empresa\": \"Empresa Ejemplo S.A.\",\n \"rfc\": \"ABC123456789\",\n \"calle\": \"Av. Insurgentes\",\n \"numero\": \"123\",\n \"referencia\": \"Referencia\"\n },\n \"destino\": {\n \"alias\": \"alias-destino\",\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"nombre\": \"Juan Pérez\",\n \"estado\": \"Ciudad de México\",\n \"colonia\": \"Centro (Área 6)\",\n \"email\": \"juan.perez@example.com\",\n \"telefono\": \"5512345678\",\n \"empresa\": \"Empresa Ejemplo S.A.\",\n \"rfc\": \"ABC123456789\",\n \"calle\": \"Av. Insurgentes\",\n \"numero\": \"123\",\n \"referencia\": \"Referencia\"\n },\n \"estado\": \"completo\",\n \"resumen\": {\n \"total_solicitadas\": 1,\n \"exitosas\": 1,\n \"fallidas\": 0,\n \"costo_total\": 146.85,\n \"fecha_procesamiento\": \"2025-08-21T18:04:03.116Z\",\n \"tiempo_procesamiento\": 13004\n },\n \"createdAt\": \"2025-08-21T18:04:03.123Z\",\n \"updatedAt\": \"2025-08-21T18:04:03.123Z\",\n \"guias\": [\n {\n \"numero_guia\": \"883756934507\",\n \"shipment_id\": \"543757d9-8f7c-44b3-b3c7-25db8c68175a\",\n \"parcel_id\": \"4f9e9d61-104a-442c-9c82-07a5310365dd\"\n }\n ],\n \"envio\": [\n {\n \"indice\": 1,\n \"envio_id\": \"543757d9-8f7c-44b3-b3c7-25db8c68175a\",\n \"servicio\": \"FedEx Terrestre cl\",\n \"costo\": 146.85,\n \"guia\": \"883756934507\",\n \"estado\": \"generada\",\n \"fecha_generacion\": \"2025-08-21T18:04:03.116Z\"\n }\n ]\n },\n {\n \"id\": \"68a75a5a779d0f27a389d211\",\n \"origen\": {\n \"alias\": \"alias-origen\",\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"nombre\": \"Juan Pérez\",\n \"estado\": \"Ciudad de México\",\n \"colonia\": \"Centro (Área 6)\",\n \"email\": \"juan.perez@example.com\",\n \"telefono\": \"5512345678\",\n \"empresa\": \"Empresa Ejemplo S.A.\",\n \"rfc\": \"ABC123456789\",\n \"calle\": \"Av. Insurgentes\",\n \"numero\": \"123\",\n \"referencia\": \"Referencia\"\n },\n \"destino\": {\n \"alias\": \"alias-destino\",\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"nombre\": \"Juan Pérez\",\n \"estado\": \"Ciudad de México\",\n \"colonia\": \"Centro (Área 6)\",\n \"email\": \"juan.perez@example.com\",\n \"telefono\": \"5512345678\",\n \"empresa\": \"Empresa Ejemplo S.A.\",\n \"rfc\": \"ABC123456789\",\n \"calle\": \"Av. Insurgentes\",\n \"numero\": \"123\",\n \"referencia\": \"Referencia\"\n },\n \"estado\": \"completo\",\n \"resumen\": {\n \"total_solicitadas\": 1,\n \"exitosas\": 1,\n \"fallidas\": 0,\n \"costo_total\": 153.4,\n \"fecha_procesamiento\": \"2025-08-21T17:41:46.797Z\",\n \"tiempo_procesamiento\": 14826\n },\n \"createdAt\": \"2025-08-21T17:41:46.799Z\",\n \"updatedAt\": \"2025-08-21T17:41:46.799Z\",\n \"guias\": [\n {\n \"numero_guia\": \"883756153853\",\n \"shipment_id\": \"84ae365f-47c8-4d7c-a6e7-fcbddda628a0\",\n \"parcel_id\": \"3474829b-8c68-4466-b609-c8c08f6b21a7\"\n }\n ],\n \"envio\": {\n \"servicio\": \"FedEx Dia Sig.\",\n \"costo_unitario\": 153.4,\n \"total_pago\": 153.4,\n \"cantidad_guias\": 1\n }\n },\n {\n \"id\": \"68912d2caa178a9861cea64d\",\n \"origen\": {\n \"alias\": \"origen-murimartin-wamid.HBgNNTIxNTU2ODcyNjM0MhUCABEYEjhBMjE5RDU3ODE2REQyRUQ2NgA=\",\n \"cp\": \"66358\",\n \"ciudad\": \"Santa Catarina\",\n \"nombre\": \"Abel Murillo\"\n },\n \"destino\": {\n \"alias\": \"destino-merida-wamid.HBgNNTIxNTU2ODcyNjM0MhUCABEYEjhBMjE5RDU3ODE2REQyRUQ2NgA=\",\n \"cp\": \"97166\",\n \"ciudad\": \"Mérida\",\n \"nombre\": \"Guillermo Gutierrez\"\n },\n \"estado\": \"completo\",\n \"resumen\": {\n \"total_solicitadas\": 1,\n \"exitosas\": 1,\n \"fallidas\": 0,\n \"costo_total\": 90,\n \"fecha_procesamiento\": \"2025-08-04T21:59:08.638Z\",\n \"tiempo_procesamiento\": 47432\n },\n \"createdAt\": \"2025-08-04T21:59:08.638Z\",\n \"updatedAt\": \"2025-08-04T21:59:08.638Z\",\n \"guias\": [\n {\n \"origen\": \"66358\",\n \"destino\": \"97166\",\n \"remitente\": \"Abel Murillo\",\n \"destinatario\": \"Guillermo Gutierrez\",\n \"numero_guia\": \"0108588384770721209935\",\n \"url\": \"https://6dfb173c-ee1e-4b44-a0b8-cfe67c3bef34.s3.us-west-2.amazonaws.com/uploads/label/file/87951ea1-331a-45a2-8103-57d0ee011072/a051b1a0-6f08-4b43-be36-86530e54a95e-estafeta-sin-recoleccion-mejor-precio-2025-web-service.pdf\",\n \"shipment_id\": \"a051b1a0-6f08-4b43-be36-86530e54a95e\"\n }\n ],\n \"envio\": [\n {\n \"indice\": 1,\n \"envio_id\": \"a051b1a0-6f08-4b43-be36-86530e54a95e\",\n \"servicio\": \"ESTAFETA SIN RECOLECCION MEJOR PRECIO 2025 WEB SERVICE\",\n \"costo\": 90,\n \"guia\": \"0108588384770721209935\",\n \"estado\": \"generada\",\n \"url_etiqueta\": \"https://6dfb173c-ee1e-4b44-a0b8-cfe67c3bef34.s3.us-west-2.amazonaws.com/uploads/label/file/87951ea1-331a-45a2-8103-57d0ee011072/a051b1a0-6f08-4b43-be36-86530e54a95e-estafeta-sin-recoleccion-mejor-precio-2025-web-service.pdf\",\n \"fecha_generacion\": \"2025-08-04T21:59:08.638Z\"\n }\n ]\n },\n {\n \"id\": \"688258d596fab16823f5ad05\",\n \"origen\": {\n \"alias\": \"testcacheo\",\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"nombre\": \"Juan Pérez\"\n },\n \"destino\": {\n \"alias\": \"testcacheo\",\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"nombre\": \"Juan Pérez\"\n },\n \"estado\": \"completo\",\n \"resumen\": {\n \"total_solicitadas\": 1,\n \"exitosas\": 1,\n \"fallidas\": 0,\n \"costo_total\": 112.77,\n \"fecha_procesamiento\": \"2025-07-24T16:01:25.901Z\",\n \"tiempo_procesamiento\": 8942\n },\n \"createdAt\": \"2025-07-24T16:01:25.903Z\",\n \"updatedAt\": \"2025-07-24T16:01:25.903Z\",\n \"guias\": [\n {\n \"origen\": \"06060\",\n \"destino\": \"06060\",\n \"remitente\": \"Juan Pérez\",\n \"destinatario\": \"Juan Pérez\",\n \"numero_guia\": \"883034879105\",\n \"url\": \"https://6dfb173c-ee1e-4b44-a0b8-cfe67c3bef34.s3.us-west-2.amazonaws.com/uploads/label/file/4bdd1c85-6e45-470f-a2d0-fe874a0ab157/33a6e988-f497-4bad-948b-931e7f038804-fedex-nacional-mejor-precio-1-20kgs-huert.pdf\",\n \"shipment_id\": \"33a6e988-f497-4bad-948b-931e7f038804\"\n }\n ],\n \"envio\": [\n {\n \"indice\": 1,\n \"envio_id\": \"33a6e988-f497-4bad-948b-931e7f038804\",\n \"servicio\": \"FEDEX NACIONAL MEJOR PRECIO 1-20KGS Huert\",\n \"costo\": 112.77,\n \"guia\": \"883034879105\",\n \"estado\": \"generada\",\n \"url_etiqueta\": \"https://6dfb173c-ee1e-4b44-a0b8-cfe67c3bef34.s3.us-west-2.amazonaws.com/uploads/label/file/4bdd1c85-6e45-470f-a2d0-fe874a0ab157/33a6e988-f497-4bad-948b-931e7f038804-fedex-nacional-mejor-precio-1-20kgs-huert.pdf\",\n \"fecha_generacion\": \"2025-07-24T16:01:25.901Z\"\n }\n ]\n },\n {\n \"id\": \"68815d3a382bfd38d086d3a3\",\n \"origen\": {\n \"alias\": \"origen-Isai Gerardo Perez-wamid.HBgNNTIxNTU2ODcyNjM0MhUCABEYEjczMTJEMkVBNTUwOEJEQTNFQwA=\",\n \"cp\": \"72864\",\n \"ciudad\": \"Ocoyucan\",\n \"nombre\": \"Isai Gerardo Perez\"\n },\n \"destino\": {\n \"alias\": \"destino-Casa Merida-wamid.HBgNNTIxNTU2ODcyNjM0MhUCABEYEjczMTJEMkVBNTUwOEJEQTNFQwA=\",\n \"cp\": \"97166\",\n \"ciudad\": \"Mérida\",\n \"nombre\": \"Guillermo Gutierrez\"\n },\n \"estado\": \"completo\",\n \"resumen\": {\n \"total_solicitadas\": 1,\n \"exitosas\": 1,\n \"fallidas\": 0,\n \"costo_total\": 290,\n \"fecha_procesamiento\": \"2025-07-23T22:07:54.013Z\",\n \"tiempo_procesamiento\": 82235\n },\n \"createdAt\": \"2025-07-23T22:07:54.013Z\",\n \"updatedAt\": \"2025-07-23T22:07:54.013Z\",\n \"guias\": [\n {\n \"origen\": \"72864\",\n \"destino\": \"97166\",\n \"remitente\": \"Isai Gerardo Perez\",\n \"destinatario\": \"Guillermo Gutierrez\",\n \"numero_guia\": \"8555909522595700041587\",\n \"url\": \"https://6dfb173c-ee1e-4b44-a0b8-cfe67c3bef34.s3.us-west-2.amazonaws.com/uploads/label/file/19b91111-267b-4552-900e-275309202e1b/693712ab-6852-47dc-a706-aa9d7d055d69-estafeta-terrestre.pdf\",\n \"shipment_id\": \"693712ab-6852-47dc-a706-aa9d7d055d69\"\n }\n ],\n \"envio\": [\n {\n \"indice\": 1,\n \"envio_id\": \"693712ab-6852-47dc-a706-aa9d7d055d69\",\n \"servicio\": \"ESTAFETA TERRESTRE\",\n \"costo\": 290,\n \"guia\": \"8555909522595700041587\",\n \"estado\": \"generada\",\n \"url_etiqueta\": \"https://6dfb173c-ee1e-4b44-a0b8-cfe67c3bef34.s3.us-west-2.amazonaws.com/uploads/label/file/19b91111-267b-4552-900e-275309202e1b/693712ab-6852-47dc-a706-aa9d7d055d69-estafeta-terrestre.pdf\",\n \"fecha_generacion\": \"2025-07-23T22:07:54.013Z\"\n }\n ]\n },\n {\n \"id\": \"688002a604fae88c5dc9ee98\",\n \"origen\": {\n \"alias\": \"origen-Casa Principal-wamid.HBgNNTIxNTU2ODcyNjM0MhUCABEYEkEyN0REMjI4MTMzOTEzOTRENAA=\",\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"nombre\": \"Juan Pérez\"\n },\n \"destino\": {\n \"alias\": \"destino-Casa Principal-wamid.HBgNNTIxNTU2ODcyNjM0MhUCABEYEkEyN0REMjI4MTMzOTEzOTRENAA=\",\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"nombre\": \"Juan Pérez\"\n },\n \"estado\": \"completo\",\n \"resumen\": {\n \"total_solicitadas\": 1,\n \"exitosas\": 1,\n \"fallidas\": 0,\n \"costo_total\": 112.77,\n \"fecha_procesamiento\": \"2025-07-22T21:29:10.331Z\",\n \"tiempo_procesamiento\": 82548\n },\n \"createdAt\": \"2025-07-22T21:29:10.332Z\",\n \"updatedAt\": \"2025-07-22T21:29:10.332Z\",\n \"guias\": [\n {\n \"origen\": \"06060\",\n \"destino\": \"06060\",\n \"remitente\": \"Juan Pérez\",\n \"destinatario\": \"Juan Pérez\",\n \"numero_guia\": \"882983974628\",\n \"url\": \"https://6dfb173c-ee1e-4b44-a0b8-cfe67c3bef34.s3.us-west-2.amazonaws.com/uploads/label/file/99243664-3e8f-44bd-b7ec-932d70d99a77/3e822c9f-2cf4-41c7-8305-042f1fac29c8-fedex-nacional-mejor-precio-1-20kgs-huert.pdf\",\n \"shipment_id\": \"3e822c9f-2cf4-41c7-8305-042f1fac29c8\"\n }\n ],\n \"envio\": [\n {\n \"indice\": 1,\n \"envio_id\": \"3e822c9f-2cf4-41c7-8305-042f1fac29c8\",\n \"servicio\": \"FEDEX NACIONAL MEJOR PRECIO 1-20KGS Huert\",\n \"costo\": 112.77,\n \"guia\": \"882983974628\",\n \"estado\": \"generada\",\n \"url_etiqueta\": \"https://6dfb173c-ee1e-4b44-a0b8-cfe67c3bef34.s3.us-west-2.amazonaws.com/uploads/label/file/99243664-3e8f-44bd-b7ec-932d70d99a77/3e822c9f-2cf4-41c7-8305-042f1fac29c8-fedex-nacional-mejor-precio-1-20kgs-huert.pdf\",\n \"fecha_generacion\": \"2025-07-22T21:29:10.331Z\"\n }\n ]\n },\n {\n \"id\": \"6880025104fae88c5dc9ee1a\",\n \"origen\": {\n \"alias\": \"origen-Casa Principal-wamid.HBgNNTIxNTU2ODcyNjM0MhUCABEYEkEyN0REMjI4MTMzOTEzOTRENAA=\",\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"nombre\": \"Juan Pérez\"\n },\n \"destino\": {\n \"alias\": \"destino-Casa Principal-wamid.HBgNNTIxNTU2ODcyNjM0MhUCABEYEkEyN0REMjI4MTMzOTEzOTRENAA=\",\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"nombre\": \"Juan Pérez\"\n },\n \"estado\": \"completo\",\n \"resumen\": {\n \"total_solicitadas\": 1,\n \"exitosas\": 1,\n \"fallidas\": 0,\n \"costo_total\": 112.77,\n \"fecha_procesamiento\": \"2025-07-22T21:27:45.883Z\",\n \"tiempo_procesamiento\": 66142\n },\n \"createdAt\": \"2025-07-22T21:27:45.884Z\",\n \"updatedAt\": \"2025-07-22T21:27:45.884Z\",\n \"guias\": [\n {\n \"origen\": \"06060\",\n \"destino\": \"06060\",\n \"remitente\": \"Juan Pérez\",\n \"destinatario\": \"Juan Pérez\",\n \"numero_guia\": \"882983945448\",\n \"url\": \"https://6dfb173c-ee1e-4b44-a0b8-cfe67c3bef34.s3.us-west-2.amazonaws.com/uploads/label/file/4a275f89-b8f9-43b5-8a8f-b7a01841eee4/1e37389f-c499-40ae-8b10-d005d251d6f1-fedex-nacional-mejor-precio-1-20kgs-huert.pdf\",\n \"shipment_id\": \"1e37389f-c499-40ae-8b10-d005d251d6f1\"\n }\n ],\n \"envio\": [\n {\n \"indice\": 1,\n \"envio_id\": \"1e37389f-c499-40ae-8b10-d005d251d6f1\",\n \"servicio\": \"FEDEX NACIONAL MEJOR PRECIO 1-20KGS Huert\",\n \"costo\": 112.77,\n \"guia\": \"882983945448\",\n \"estado\": \"generada\",\n \"url_etiqueta\": \"https://6dfb173c-ee1e-4b44-a0b8-cfe67c3bef34.s3.us-west-2.amazonaws.com/uploads/label/file/4a275f89-b8f9-43b5-8a8f-b7a01841eee4/1e37389f-c499-40ae-8b10-d005d251d6f1-fedex-nacional-mejor-precio-1-20kgs-huert.pdf\",\n \"fecha_generacion\": \"2025-07-22T21:27:45.883Z\"\n }\n ]\n },\n {\n \"id\": \"688001ea04fae88c5dc9ed06\",\n \"origen\": {\n \"alias\": \"origen-Casa Principal-wamid.HBgNNTIxNTU2ODcyNjM0MhUCABEYEjExNjI1RUI5OTVDRDA4QjAyMwA=\",\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"nombre\": \"Juan Pérez\"\n },\n \"destino\": {\n \"alias\": \"destino-Casa Principal-wamid.HBgNNTIxNTU2ODcyNjM0MhUCABEYEjExNjI1RUI5OTVDRDA4QjAyMwA=\",\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"nombre\": \"Juan Pérez\"\n },\n \"estado\": \"completo\",\n \"resumen\": {\n \"total_solicitadas\": 1,\n \"exitosas\": 1,\n \"fallidas\": 0,\n \"costo_total\": 112.77,\n \"fecha_procesamiento\": \"2025-07-22T21:26:02.948Z\",\n \"tiempo_procesamiento\": 81684\n },\n \"createdAt\": \"2025-07-22T21:26:02.948Z\",\n \"updatedAt\": \"2025-07-22T21:26:02.948Z\",\n \"guias\": [\n {\n \"origen\": \"06060\",\n \"destino\": \"06060\",\n \"remitente\": \"Juan Pérez\",\n \"destinatario\": \"Juan Pérez\",\n \"numero_guia\": \"882983902147\",\n \"url\": \"https://6dfb173c-ee1e-4b44-a0b8-cfe67c3bef34.s3.us-west-2.amazonaws.com/uploads/label/file/275d6f90-f534-4de4-a483-c96eccabf02a/e8388758-bfde-4043-8d2f-61e5f5f4ff99-fedex-nacional-mejor-precio-1-20kgs-huert.pdf\",\n \"shipment_id\": \"e8388758-bfde-4043-8d2f-61e5f5f4ff99\"\n }\n ],\n \"envio\": [\n {\n \"indice\": 1,\n \"envio_id\": \"e8388758-bfde-4043-8d2f-61e5f5f4ff99\",\n \"servicio\": \"FEDEX NACIONAL MEJOR PRECIO 1-20KGS Huert\",\n \"costo\": 112.77,\n \"guia\": \"882983902147\",\n \"estado\": \"generada\",\n \"url_etiqueta\": \"https://6dfb173c-ee1e-4b44-a0b8-cfe67c3bef34.s3.us-west-2.amazonaws.com/uploads/label/file/275d6f90-f534-4de4-a483-c96eccabf02a/e8388758-bfde-4043-8d2f-61e5f5f4ff99-fedex-nacional-mejor-precio-1-20kgs-huert.pdf\",\n \"fecha_generacion\": \"2025-07-22T21:26:02.948Z\"\n }\n ]\n },\n {\n \"id\": \"687ffbd304fae88c5dc9e594\",\n \"origen\": {\n \"alias\": \"origen-Casa Principal-wamid.HBgNNTIxNTU2ODcyNjM0MhUCABEYEjgwNERDOTVDRkJGQzMxRjMxMwA=\",\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"nombre\": \"Juan Pérez\"\n },\n \"destino\": {\n \"alias\": \"destino-Casa Principal-wamid.HBgNNTIxNTU2ODcyNjM0MhUCABEYEjgwNERDOTVDRkJGQzMxRjMxMwA=\",\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"nombre\": \"Juan Pérez\"\n },\n \"estado\": \"completo\",\n \"resumen\": {\n \"total_solicitadas\": 1,\n \"exitosas\": 1,\n \"fallidas\": 0,\n \"costo_total\": 112.77,\n \"fecha_procesamiento\": \"2025-07-22T21:00:03.883Z\",\n \"tiempo_procesamiento\": 72095\n },\n \"createdAt\": \"2025-07-22T21:00:03.883Z\",\n \"updatedAt\": \"2025-07-22T21:00:03.883Z\",\n \"guias\": [\n {\n \"origen\": \"06060\",\n \"destino\": \"06060\",\n \"remitente\": \"Juan Pérez\",\n \"destinatario\": \"Juan Pérez\",\n \"numero_guia\": \"882983225057\",\n \"url\": \"https://6dfb173c-ee1e-4b44-a0b8-cfe67c3bef34.s3.us-west-2.amazonaws.com/uploads/label/file/61392a39-0193-435c-bcd1-b58c7a1f8b05/323838c6-11c2-4374-941b-091c9996c8d7-fedex-nacional-mejor-precio-1-20kgs-huert.pdf\",\n \"shipment_id\": \"323838c6-11c2-4374-941b-091c9996c8d7\"\n }\n ],\n \"envio\": [\n {\n \"indice\": 1,\n \"envio_id\": \"323838c6-11c2-4374-941b-091c9996c8d7\",\n \"servicio\": \"FEDEX NACIONAL MEJOR PRECIO 1-20KGS Huert\",\n \"costo\": 112.77,\n \"guia\": \"882983225057\",\n \"estado\": \"generada\",\n \"url_etiqueta\": \"https://6dfb173c-ee1e-4b44-a0b8-cfe67c3bef34.s3.us-west-2.amazonaws.com/uploads/label/file/61392a39-0193-435c-bcd1-b58c7a1f8b05/323838c6-11c2-4374-941b-091c9996c8d7-fedex-nacional-mejor-precio-1-20kgs-huert.pdf\",\n \"fecha_generacion\": \"2025-07-22T21:00:03.883Z\"\n }\n ]\n }\n ],\n \"meta\": {\n \"page\": 1,\n \"limit\": 10,\n \"total\": 15,\n \"pages\": 2,\n \"hasNext\": true,\n \"hasPrev\": false\n }\n}"}],"_postman_id":"2a115ba1-caad-40ed-8764-88e827328514"},{"name":"Listar Envio por Id","id":"14fd992a-d0c0-46b6-83a2-ca6dbe68d632","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api-envios.appsincode.com/api/v2/envios/68912d2caa178a9861cea64d","description":"

Método: GET

URL: https://api-envios.appsincode.com/api/v2/envio?id=id

Descripción:
Este endpoint permite obtener el envio asociado al usuario autenticado. Si se proporciona el parámetro de consulta id, se obtiene un único envío correspondiente al ID especificado. Es necesario autenticar la solicitud mediante una API Key válida.

Autenticación:
Requiere API Key en el encabezado de la solicitud.

Parámetros de consulta (opcional):

id (string): ID único del envío a consultar.

Respuestas:

✔️ 200 OK - Cuando se encuentran envíos:

{\n  \"success\": true,\n  \"message\": \"Envíos encontrados exitosamente.\",\n  \"total\": 3,\n  \"data\": [\n    { \"_id\": \"...\", \"destino\": \"...\", ... },\n    { \"_id\": \"...\", \"destino\": \"...\", ... },\n    ...\n  ],\n  \"durationMs\": 217\n}\n\n

⚠️ 404 Not Found - Cuando no se encuentran resultados:

{\n  \"success\": false,\n  \"message\": \"No se encontraron envíos.\",\n  \"total\": 0,\n  \"durationMs\": 217\n}\n\n

❌ 500 Internal Server Error - Error interno del servidor:

{\n  \"success\": false,\n  \"message\": \"Error interno al procesar la solicitud.\",\n  \"error\": \"Descripción del error\",\n  \"durationMs\": 432\n}\n\n

Notas:

El tiempo de ejecución de la solicitud está expresado en milisegundos (durationMs).
\n
Se recomienda manejar adecuadamente los códigos de estado HTTP para una mejor experiencia de usuario.
\n

\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"d470d245-9dd4-4af5-9ae4-55100fd71b7a","id":"d470d245-9dd4-4af5-9ae4-55100fd71b7a","name":"Envios API","type":"collection"}},"urlObject":{"path":["envios","68912d2caa178a9861cea64d"],"host":["https://api-envios.appsincode.com/api/v2"],"query":[],"variable":[]}},"response":[{"id":"27e9b721-6081-4d68-b622-cef5581f46ee","name":"404 - No se encontraron envios","originalRequest":{"method":"GET","header":[],"url":"/envio"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"RateLimit-Policy","value":"100;w=60"},{"key":"RateLimit-Limit","value":"100"},{"key":"RateLimit-Remaining","value":"98"},{"key":"RateLimit-Reset","value":"2"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"83"},{"key":"ETag","value":"W/\"53-Ek4nNKEOdqrIbUTbmtqEDTBLsSk\""},{"key":"Date","value":"Tue, 27 May 2025 21:05:40 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"No se encontraron envíos.\",\n \"total\": 0,\n \"durationMs\": 217\n}"},{"id":"2b69f069-df79-4338-a1fe-100301babbf6","name":"200 - Exito","originalRequest":{"method":"GET","header":[],"url":{"raw":"/envio?id=","host":[""],"path":["envio"],"query":[{"key":"id","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"RateLimit-Policy","value":"100;w=60"},{"key":"RateLimit-Limit","value":"100"},{"key":"RateLimit-Remaining","value":"99"},{"key":"RateLimit-Reset","value":"60"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"1655"},{"key":"ETag","value":"W/\"677-jdSIblE0azuDmqDAZ7WM2z9PSvE\""},{"key":"Set-Cookie","value":"connect.sid=s%3A0wgMnXVoapzUUbP7at8gVO2b0Qt7h9VV.N5uMd7a33%2F04C%2BJTcHA8V%2FFgT5LoArh8WyXp%2BmpyBpU; Path=/; HttpOnly"},{"key":"Date","value":"Tue, 27 May 2025 21:17:02 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Envío encontrado exitosamente.\",\n \"durationMs\": 209,\n \"envio\": {\n \"id\": \"682fa9aa2d2c717f45cc4d23\",\n \"origen\": {\n \"_id\": \"682fa9672d2c717f45cc4d01\",\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"estado\": \"Ciudad de México\",\n \"colonia\": \"Centro (Área 6)\",\n \"nombre\": \"Juan Pérez\",\n \"email\": \"juan.perez@example.com\",\n \"telefono\": \"5512345678\",\n \"empresa\": \"Empresa Ejemplo S.A.\",\n \"rfc\": \"ABC123456789\",\n \"calle\": \"Av. Insurgentes\",\n \"numero\": \"123\",\n \"referencia\": \"Referencia \",\n \"alias\": \"test123456\",\n \"users\": \"67c0fd8a6d1adf755abb17cf\",\n \"createdAt\": \"2025-05-22T22:47:03.447Z\",\n \"updatedAt\": \"2025-05-22T22:47:03.447Z\",\n \"__v\": 0\n },\n \"destino\": {\n \"_id\": \"682fa9672d2c717f45cc4d01\",\n \"cp\": \"06060\",\n \"ciudad\": \"Cuauhtémoc\",\n \"estado\": \"Ciudad de México\",\n \"colonia\": \"Centro (Área 6)\",\n \"nombre\": \"Juan Pérez\",\n \"email\": \"juan.perez@example.com\",\n \"telefono\": \"5512345678\",\n \"empresa\": \"Empresa Ejemplo S.A.\",\n \"rfc\": \"ABC123456789\",\n \"calle\": \"Av. Insurgentes\",\n \"numero\": \"123\",\n \"referencia\": \"Referencia \",\n \"alias\": \"test123456\",\n \"users\": \"67c0fd8a6d1adf755abb17cf\",\n \"createdAt\": \"2025-05-22T22:47:03.447Z\",\n \"updatedAt\": \"2025-05-22T22:47:03.447Z\",\n \"__v\": 0\n },\n \"envio\": [\n {\n \"indice\": 1,\n \"envio_id\": \"3641e61b-81e2-4e93-b525-17e43ad8372d\",\n \"servicio\": \"FEDEX ÚLTIMA MILLA 1-5KGS Huert\",\n \"costo\": \"107.14\",\n \"guia\": \"881471803651\",\n \"estado\": \"generada\"\n }\n ],\n \"guias\": [\n {\n \"origen\": \"06060\",\n \"destino\": \"06060\",\n \"remitente\": \"Juan Pérez\",\n \"destinatario\": \"Juan Pérez\",\n \"numero_guia\": \"881471803651\",\n \"url\": \"https://6dfb173c-ee1e-4b44-a0b8-cfe67c3bef34.s3.us-west-2.amazonaws.com/uploads/label/file/9ba5242e-c128-46c8-8e37-1c23d2033cee/3641e61b-81e2-4e93-b525-17e43ad8372d-fedex-ultima-milla-1-5kgs-huert.pdf\",\n \"shipment_id\": \"3641e61b-81e2-4e93-b525-17e43ad8372d\"\n }\n ]\n }\n}"}],"_postman_id":"14fd992a-d0c0-46b6-83a2-ca6dbe68d632"}],"id":"4adf3581-e10d-4309-ba14-202c86d1135c","_postman_id":"4adf3581-e10d-4309-ba14-202c86d1135c","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"d470d245-9dd4-4af5-9ae4-55100fd71b7a","id":"d470d245-9dd4-4af5-9ae4-55100fd71b7a","name":"Envios API","type":"collection"}}},{"name":"Herramientas","item":[{"name":"Saldo","id":"94e40e11-7c4c-484d-9e66-43bf2bd5851f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"https://api-envios.appsincode.com/api/v2/balance","urlObject":{"path":["balance"],"host":["https://api-envios.appsincode.com/api/v2"],"query":[],"variable":[]}},"response":[{"id":"ef05fab4-a2d6-42b0-b6c4-d9524f888d8d","name":"200 - Saldo Obtenido","originalRequest":{"method":"GET","header":[],"url":"https://api-envios.appsincode.com/api/v2/balance"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 11 Jun 2025 15:05:03 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Server","value":"cloudflare"},{"key":"Nel","value":"{\"report_to\":\"cf-nel\",\"success_fraction\":0.0,\"max_age\":604800}"},{"key":"X-Powered-By","value":"Express"},{"key":"Ratelimit-Policy","value":"100;w=60"},{"key":"Ratelimit-Limit","value":"100"},{"key":"Ratelimit-Remaining","value":"96"},{"key":"Ratelimit-Reset","value":"1"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Etag","value":"W/\"6f-g2DzddOFWkrUNYE9u07O77A7P4k\""},{"key":"X-Cache","value":"MISS"},{"key":"Cf-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"group\":\"cf-nel\",\"max_age\":604800,\"endpoints\":[{\"url\":\"https://a.nel.cloudflare.com/report/v4?s=NhwVkmd8bm7w4ZUxtPoPTKUw7eEfLwt8Mva5oK5uXTYo1AWhiYXwy0u0g5HgD87VgH2sJ5tCHOqyrq19NhE1K7uYrZZYYXuI1LA6crRV5rhU%2B8PhlrTaNwo%3D\"}]}"},{"key":"Content-Encoding","value":"br"},{"key":"CF-RAY","value":"94e20121694a479d-DFW"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"Saldo obtenido exitosamente.\",\n \"balance\": \"19100.00\",\n \"formatted_balance\": \"$19,100.00\"\n}"}],"_postman_id":"94e40e11-7c4c-484d-9e66-43bf2bd5851f"},{"name":"Consulta SAT Id","id":"f01a0933-4e07-48dd-8812-e3fa5ccb632d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"https://api-envios.appsincode.com/api/v2/sat?termino=","description":"

Código SAT

Este endpoint permite buscar y obtener una lista de códigos SAT que coincidan con un término de búsqueda específico.

URL

/sat?termino={termino_de_busqueda}

Método

GET

Headers

Authorization: {{token}}

Parámetros de Consulta

termino (string): Término de búsqueda para filtrar los códigos SAT. Este parámetro es obligatorio y no puede estar vacío.

Ejemplo de Solicitud

GET /sat?termino=alimentos\n\n

Validaciones

Parámetro de Búsqueda: El parámetro termino debe proporcionarse y no puede estar vacío. Si falta o está vacío, se devuelve un error.

Respuestas

Respuesta Exitosa (200 OK)

Devuelve un arreglo de objetos con los códigos SAT que coinciden con el término de búsqueda.

[ { \"codigo\": \"10101501\", \"descripcion\": \"Alimentos procesados\" }, { \"codigo\": \"10101502\", \"descripcion\": \"Frutas frescas\" }]

Errores Comunes

{ \"message\": \"El parámetro de búsqueda 'termino' es requerido y no puede estar vacío.\"}
\n
{ \"message\": \"No se encontraron códigos SAT para el término de búsqueda proporcionado.\"}
\n
{ \"message\": \"Error al obtener los códigos SAT.\"}
\n

Logs Generados

Advertencia (WARN): Cuando el parámetro termino no se proporciona o cuando no se encuentran resultados para el término de búsqueda.
\n
Información (INFO): Cuando se recibe una solicitud para obtener códigos SAT y cuando los códigos se obtienen exitosamente.
\n
Error (ERROR): Cuando ocurre un error en el servidor durante la obtención de los códigos SAT.
\n

\n","urlObject":{"path":["sat"],"host":["https://api-envios.appsincode.com/api/v2"],"query":[{"key":"termino","value":""}],"variable":[]}},"response":[{"id":"2eaa5085-0436-4280-a0d7-75afd71acce7","name":"200","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api-envios.appsincode.com/api/v2/sat?termino=camisetas","host":["https://api-envios.appsincode.com/api/v2"],"path":["sat"],"query":[{"key":"termino","value":"camisetas"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"179"},{"key":"ETag","value":"W/\"b3-RMuKsciCPF2FW7ekSBIHFr/BHc4\""},{"key":"Date","value":"Sat, 02 Nov 2024 20:23:13 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"codigo\": \"53102301\",\n \"descripcion\": \"Camisetas interiores\"\n },\n {\n \"codigo\": \"53103000\",\n \"descripcion\": \"Camisetas\"\n },\n {\n \"codigo\": \"53103001\",\n \"descripcion\": \"Camisetas (t-shirts) para hombre\"\n }\n]"},{"id":"e69767f4-748f-4bda-95ab-4460ffd59216","name":"400","originalRequest":{"method":"GET","header":[],"url":"https://api-envios.appsincode.com/api/v2/sat"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"88"},{"key":"ETag","value":"W/\"58-op515ajtbu/z4c1LLyTuncxRvKk\""},{"key":"Set-Cookie","value":"connect.sid=s%3AkSfmxELYtKDUX-VtkYD2OE4cex1HHAct.39ciPpAbfhc3qQvr9MY9uqCyEno8BBPbdINbRPtGNv4; Path=/; HttpOnly"},{"key":"Date","value":"Sat, 02 Nov 2024 20:25:36 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"El parámetro de búsqueda 'termino' es requerido y no puede estar vacío.\"\n}"}],"_postman_id":"f01a0933-4e07-48dd-8812-e3fa5ccb632d"},{"name":"Listar Servicios","id":"37ceaf4c-44e4-4640-9a50-0d0f51cb408b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"https://api-envios.appsincode.com/api/v2/servicios","description":"

Listar Servicios de Envío

Este endpoint permite obtener una lista de servicios de envío disponibles para el usuario autenticado.

URL

/servicios

Método

GET

Headers

Authorization: {{token}}

Descripción

Devuelve una lista de servicios de envío asociados al usuario autenticado.

Ejemplo de Solicitud

GET /servicios\n\n

Respuestas

Respuesta Exitosa (200 OK)

Devuelve un arreglo de objetos con los servicios de envío disponibles para el usuario.

[ { \"id\": \"servicio1\", \"nombre\": \"Envío Express\" }, { \"id\": \"servicio2\", \"nombre\": \"Envío Económico\" }]

Errores Comunes

404 Not Found:
\n
- { \"message\": \"No se encontraron servicios de envío para el usuario.\"}
\n
{ \"message\": \"Error al obtener los servicios de envío.\"}
\n

Logs Generados

Advertencia (WARN): Cuando el usuario no existe o no se encuentran servicios de envío para el usuario.
\n
Información (INFO): Cuando se recibe una solicitud para obtener servicios de envío y cuando los servicios se obtienen exitosamente.
\n
Error (ERROR): Cuando ocurre un error en el servidor durante la obtención de los servicios de envío.
\n

\n","urlObject":{"path":["servicios"],"host":["https://api-envios.appsincode.com/api/v2"],"query":[],"variable":[]}},"response":[{"id":"652a1665-a367-4dd7-bfa8-d027dd2cb5a1","name":"200","originalRequest":{"method":"GET","header":[],"url":"https://api-envios.appsincode.com/api/v2/servicios"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Powered-By","value":"Express"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"1799"},{"key":"ETag","value":"W/\"707-dt4elwf6DMJuRloZcssrEDdLV8g\""},{"key":"Date","value":"Sat, 02 Nov 2024 20:14:24 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Keep-Alive","value":"timeout=5"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"id\": \"7d02334d-173b-4bde-9a37-0e87aec520d0\",\n \"nombre\": \"UPS Nacional (mejor precio 1 a 5 kgs.)\"\n },\n {\n \"id\": \"0b12ebba-4b0e-43b9-bae6-ece5f145bd30\",\n \"nombre\": \"DHL Express aereo (mejor precio 1 - 8kgs.)\"\n },\n {\n \"id\": \"d7417cf0-73bf-477b-91a4-0ec0a27fc799\",\n \"nombre\": \"DHL Economy Select (mejor precio 1-8kgs.)\"\n },\n {\n \"id\": \"29f242fd-7978-4db9-bea4-114109de39f3\",\n \"nombre\": \"DHL Domestic Express \\\"1\"\n },\n {\n \"id\": \"7a8d1c38-e075-4e89-9bb1-dcf43f762d5d\",\n \"nombre\": \"DHL Domestic \\\"\"\n },\n {\n \"id\": \"12d9748b-f804-455b-a8b5-dd5da43bb18b\",\n \"nombre\": \"DHL EXPRESS seguridad (con seguro directo de 3000 pesos por robo total)\"\n },\n {\n \"id\": \"7a5972c6-a204-45cd-b012-9b5e0b18787d\",\n \"nombre\": \"Estafeta Terrestre Express 1\"\n },\n {\n \"id\": \"b1438ceb-60cc-449f-b4d0-e00d0456a33c\",\n \"nombre\": \"Estafeta Aeroexpress 1\"\n },\n {\n \"id\": \"14039aa3-f06e-4bed-b651-7efa059014c7\",\n \"nombre\": \"PAQUETEXPRESS 24 horas (con seguro directo de $10,000mxn por robo)\"\n },\n {\n \"id\": \"e958fcff-8a1b-417d-991b-a475d10176c8\",\n \"nombre\": \"Paquetexpress / la cobertura se valida al generar la guia\"\n },\n {\n \"id\": \"00353885-f4b5-416d-989e-ae5a8944a30e\",\n \"nombre\": \"PAQUETEXPRESS 24 horas (con seguro directo de $5000mxn por robo)\"\n },\n {\n \"id\": \"58d09b12-a41d-4d4f-8df8-a19501da4a76\",\n \"nombre\": \"Paquetexpress el mejor servicio\"\n },\n {\n \"id\": \"4bd4c3b3-8d22-42db-9bf7-45584b9e8c98\",\n \"nombre\": \"SENDEX promocion 55 kilos Dia siguiente http://www.sendex.mx/Recoleccion/Recoleccion\"\n },\n {\n \"id\": \"502767b9-4e1d-473f-9d6c-82e90022aa57\",\n \"nombre\": \"ATENCION precios de alegria sendex ;)\"\n },\n {\n \"id\": \"088e9c93-8c9a-4621-92de-e4907070b8dd\",\n \"nombre\": \"AM-PM /mejor precio de 1 a 10 kilos\"\n },\n {\n \"id\": \"3f0792b5-37da-485d-bb43-de11a3df844c\",\n \"nombre\": \"FedEx NACIONAL KILOS GRANDES\"\n },\n {\n \"id\": \"5b70b20c-a25a-4ef1-b184-013547c484a7\",\n \"nombre\": \"FedEx Servicio Dia Siguiente\"\n },\n {\n \"id\": \"eb8605bf-fce8-4833-9c5d-a50600939003\",\n \"nombre\": \"FedEx Nacional Terrestre Elite Constructora\"\n }\n]"}],"_postman_id":"37ceaf4c-44e4-4640-9a50-0d0f51cb408b"}],"id":"e383c3c3-b031-4daf-878e-c6fb2dc7c049","_postman_id":"e383c3c3-b031-4daf-878e-c6fb2dc7c049","description":"","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"d470d245-9dd4-4af5-9ae4-55100fd71b7a","id":"d470d245-9dd4-4af5-9ae4-55100fd71b7a","name":"Envios API","type":"collection"}}}],"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":""}]}},"event":[{"listen":"prerequest","script":{"id":"f531e8e7-1fe1-4875-953e-e79219aa3368","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"0ea9358a-d431-4e99-b767-a749c8fdc0eb","type":"text/javascript","packages":{},"exec":[""]}}],"variable":[{"key":"access_token","value":""},{"key":"url","value":"https://api-envios.appsincode.com/api/v2"},{"key":"codigo_postal","value":""},{"key":"termino_busqueda","value":""},{"key":"id","value":""},{"key":"URL","value":""},{"key":"envioId","value":"68912d2caa178a9861cea64d"}]}

RESUMEN DE PROCESO ACTUALIZADO

1. Autenticación del Usuario (Token en Encabezado Authorization)

2. Consulta y Registro de Direcciones

Paso 2.1: Consultar Colonias en Base al Código Postal /colonias/?cp={codigo_postal}

Paso 2.2: Registrar Dirección de Origen /direcciones

Paso 2.3: Registrar Dirección de Destino /direcciones

3. Cotización del Envío /cotizar

4. Buscar Información en el SAT /sat?termino={terminoBusqueda}

5. Crear el Envío y Generar la Etiqueta /envio

Obtener Token

Autenticar API

Ejemplo en la Solicitud HTTP

Crear nueva direccion

URL

Método

Headers

Cuerpo de la Solicitud (JSON)

Ejemplo de Solicitud

Validaciones

Respuestas

Respuesta Exitosa (201 Created)

Errores Comunes

Logs Generados

Obtener Dirección por Id

URL

Método

Headers

Parámetros de Consulta

Ejemplo de Solicitud

Validaciones

Respuestas

Respuesta Exitosa (200 OK)

Errores Comunes

Logs Generados

Obtener Dirección por Id

URL

Método

Headers

Parámetros de Consulta

Ejemplo de Solicitud

Validaciones

Respuestas

Respuesta Exitosa (200 OK)

Errores Comunes

Logs Generados

Obtener Dirección por Id

URL

Método

Headers

Parámetros de Consulta

Ejemplo de Solicitud

Validaciones

Respuestas

Respuesta Exitosa (200 OK)

Errores Comunes

Logs Generados

Listar direcciones

URL

Método

Headers

Descripción

Ejemplo de Solicitud

Respuestas

Respuesta Exitosa (200 OK)

Errores Comunes

Logs Generados

Consultar colonias

Endpoint

Método

Headers

Parámetros de Consulta

Ejemplo de Solicitud

Respuestas

Respuesta Exitosa (200 OK)

Errores Comunes

Ejemplo de Respuesta Exitosa

Logs Generados

Cotización de Envío

Limite de Solicitudes

URL

Paso 2.1: Consultar Colonias en Base al Código Postal `/colonias/?cp={codigo_postal}`

Paso 2.2: Registrar Dirección de Origen `/direcciones`

Paso 2.3: Registrar Dirección de Destino `/direcciones`

3. Cotización del Envío `/cotizar`

4. Buscar Información en el SAT `/sat?termino={terminoBusqueda}`

5. Crear el Envío y Generar la Etiqueta `/envio`