> ## Documentation Index > Fetch the complete documentation index at: https://docs.sheeping.io/llms.txt > Use this file to discover all available pages before exploring further. # 3.- Cotizar envío > Este endpoint permite consultar los **servicios de envío disponibles** con base en el origen, destino y características del paquete. La respuesta incluye las opciones de paquetería disponibles, tiempos estimados de entrega, detalles del servicio y el desglose de costos correspondiente a cada cotización. Esta información es utilizada para comparar servicios, seleccionar la opción más adecuada según precio y tiempo de entrega, y validar la viabilidad de un envío antes de su solicitud. ## OpenAPI ````yaml /openapi.json post /v1/shipment-quotes openapi: 3.0.0 info: title: SHEEPING.IO - MODULO API version: 1.0.0 description: >- Nuestro **Módulo API** está basado en el protocolo **REST**. Todas las respuestas de las peticiones se entregan en formato **JSON** (y, en casos específicos, **HTML**). A través de los distintos **endpoints**, podrás consultar y gestionar información relacionada con **envíos**, usuarios y procesos asociados a la plataforma. Este módulo cuenta con **dos entornos disponibles**: - **Sandbox (Pruebas)** - **Producción** Para acceder a cada entorno es necesario contar con el **token de autenticación correspondiente**. ### Colección Postman El **Módulo Usuarios** proporciona una **colección en formato JSON compatible con Postman**, la cual incluye: - Ejemplos de solicitudes - Ejemplos de respuestas - Headers preconfigurados Se recomienda abrir este archivo directamente en **Postman** para facilitar la visualización, ejecución de pruebas y validación de cada endpoint de forma rápida y estructurada. --- ## URL Base y Versionado Todos los endpoints de la API están disponibles bajo la siguiente **URL base**: ``` https://apirest.sheeping.io/v1 ``` ### Versionado El **Módulo API** utiliza **versionado por URL**. En caso de futuras versiones (`/v2`, `/v3`, etc.), estas serán liberadas sin afectar las integraciones existentes. > Nota: Cualquier cambio relevante será notificado oportunamente para evitar interrupciones en los servicios ya integrados. --- ## Autenticación El **Módulo API** autenticación mediante **Bearer Token**. Cada solicitud HTTP debe incluir el token en el encabezado (`Header`) de la petición. ### Headers requeridos ``` Authorization: Bearer Content-Type: application/json ``` - El token identifica el ambiente y los permisos del cliente. - Sin un token válido, la API responderá con un **error de autenticación (401 Unauthorized)**. --- ## Ambientes disponibles El **Módulo Usuarios** proporciona **dos tokens de acceso**, uno por cada ambiente disponible. ### Sandbox (Pruebas) - Diseñado para **desarrollo y pruebas** - No genera envíos reales - No afecta datos de producción - Simula el comportamiento del entorno productivo ### Producción - Ambiente real y operativo - Genera **envíos y guías válidas** - Debe utilizarse **únicamente** después de validar la integración en Sandbox **Importante:** Es responsabilidad del usuario alternar correctamente entre los tokens de **Sandbox** y **Producción**, según el entorno en el que se encuentre trabajando. --- servers: - url: https://apirest.sheeping.io security: [] paths: /v1/shipment-quotes: post: summary: 3.- Cotizar envío description: >- Este endpoint permite consultar los **servicios de envío disponibles** con base en el origen, destino y características del paquete. La respuesta incluye las opciones de paquetería disponibles, tiempos estimados de entrega, detalles del servicio y el desglose de costos correspondiente a cada cotización. Esta información es utilizada para comparar servicios, seleccionar la opción más adecuada según precio y tiempo de entrega, y validar la viabilidad de un envío antes de su solicitud. parameters: - name: Authorization in: header schema: type: string example: Bearer requestBody: content: application/json: schema: type: object properties: origin: type: object properties: zip_code: type: string format: utc-millisec destination: type: object properties: zip_code: type: string format: utc-millisec parcel: type: object properties: dimensions: type: object properties: height: type: integer width: type: integer depth: type: integer weight: type: integer declared_value: type: integer insured: type: boolean example: origin: zip_code: '06010' destination: zip_code: '44100' parcel: dimensions: height: 10 width: 10 depth: 10 weight: 1 declared_value: 100 insured: false responses: '200': description: 200 OK headers: Date: schema: type: string example: Mon, 05 Jan 2026 07:19:34 GMT Transfer-Encoding: schema: type: string example: chunked Connection: schema: type: string example: keep-alive Server: schema: type: string example: cloudflare Nel: schema: type: string example: '{"report_to":"cf-nel","success_fraction":0.0,"max_age":604800}' Vary: schema: type: string example: Accept, Accept-Language, Origin Allow: schema: type: string example: POST, OPTIONS Content-Language: schema: type: string example: es-mx X-Frame-Options: schema: type: string example: DENY X-Content-Type-Options: schema: type: string example: nosniff Referrer-Policy: schema: type: string example: same-origin Cross-Origin-Opener-Policy: schema: type: string example: same-origin cf-cache-status: schema: type: string example: DYNAMIC Report-To: schema: type: string example: >- {"group":"cf-nel","max_age":604800,"endpoints":[{"url":"https://a.nel.cloudflare.com/report/v4?s=4K%2BuLfttEZ9VHDBokW4tXBFCx68t8OyP79EWxrrRATuII3keS13FMe9lFPJrmWaMXGZJ887ljYrfcaN3gxO%2B3bGL1EYc8hcna%2B8ZZnkBITAQFOT9tm%2F8M5tvRgvd9EQ%3D"}]} Content-Encoding: schema: type: string example: br CF-RAY: schema: type: string example: 9b913546fadf21b2-GDL alt-svc: schema: type: string example: h3=":443"; ma=86400 content: application/json: schema: type: object properties: origin: type: object properties: zip_code: type: string format: utc-millisec city: type: string state: type: string destination: type: object properties: zip_code: type: string format: utc-millisec city: type: string state: type: string parcel: type: object properties: dimensions: type: object properties: height: type: integer width: type: integer depth: type: integer weight: type: integer declared_value: type: integer insured: type: boolean volumetric_weight: type: integer total_weight: type: integer shipment_quotes: type: array items: type: object properties: shipment: type: object properties: carrier: type: object properties: company_name: type: string service_name: type: string service_image_url: type: string format: uri service_code: type: string delivery: type: object properties: estimated_days: type: string estimated_date: type: string format: date type: type: string zone: type: string format: utc-millisec extended_area: type: boolean quotes: type: object properties: base: type: integer extra_weight: type: integer excess_weight: type: integer excess_dimensions: type: integer extended_area: type: integer zonification: type: integer fuel: type: integer insurance: type: integer subtotal: type: integer iva: type: integer total: type: integer currency: type: string transaction_id: type: string example: origin: zip_code: '06010' city: Cuauhtemoc state: Ciudad de Mexico destination: zip_code: '44100' city: Guadalajara state: Jalisco parcel: dimensions: height: 10 width: 10 depth: 10 weight: 1 declared_value: 100 insured: false volumetric_weight: 1 total_weight: 1 shipment_quotes: - shipment: carrier: company_name: FEDEX service_name: FEDEX EXPRESS SAVER service_code: FEDEX_NACIONAL_ECONOMICO service_image_url: >- https://apirest.sheeping.io/media/services/fedex-logo_yMXXDkB.webp capabilities: supports_cancellation: false supports_pickup: false supports_pickup_cancellation: false delivery: estimated_days: 1 a 3 días hábiles estimated_date: '2026-01-06' type: NORMAL zone: '4' extended_area: false remote_area: false quotes: base: 200 fast_delivery: 0 extra_weight: 0 excess_weight: 0 excess_dimensions: 0 extended_area: 0 remote_area: 0 zonification: 0 fuel: 0 insurance: 0 subtotal: 200 iva: 32 total: 232 currency: MXN transaction_id: d9eab3de-1224-448e-9bb7-90ecee348d57 '400': description: 400 Bad Request headers: Date: schema: type: string example: Mon, 05 Jan 2026 06:53:52 GMT Transfer-Encoding: schema: type: string example: chunked Connection: schema: type: string example: keep-alive Server: schema: type: string example: cloudflare Nel: schema: type: string example: '{"report_to":"cf-nel","success_fraction":0.0,"max_age":604800}' Vary: schema: type: string example: Accept, Accept-Language, Origin Allow: schema: type: string example: GET, HEAD, OPTIONS Content-Language: schema: type: string example: es-mx X-Frame-Options: schema: type: string example: DENY X-Content-Type-Options: schema: type: string example: nosniff Referrer-Policy: schema: type: string example: same-origin Cross-Origin-Opener-Policy: schema: type: string example: same-origin cf-cache-status: schema: type: string example: DYNAMIC Report-To: schema: type: string example: >- {"group":"cf-nel","max_age":604800,"endpoints":[{"url":"https://a.nel.cloudflare.com/report/v4?s=MsSOiElBXdy7egeMjf5EHJJ3vVtuNtAFQJy8bXY7AuafZga5R4wSidRB0SGG8hq6DBr3vIS%2FvEl14nwa0nlDtpxvOb5FQJkVfaemyFOgRmdbxSapopwhLroYefpi8Ko%3D"}]} Content-Encoding: schema: type: string example: br CF-RAY: schema: type: string example: 9b910f9e8aaa219e-GDL alt-svc: schema: type: string example: h3=":443"; ma=86400 content: application/json: schema: type: object properties: error: type: object properties: code: type: string message: type: string details: type: object properties: origin: type: object properties: zip_code: type: array items: type: string transaction_id: type: string example: error: code: INVALID_ZIP_CODE message: El código postal de origen es incorrecto. details: origin: zip_code: - El código postal proporcionado no es válido. transaction_id: 20c5cf82-e740-4e09-a0d0-7c906a53ab18 '401': description: 401 Unauthorized headers: Date: schema: type: string example: Mon, 05 Jan 2026 06:38:27 GMT Transfer-Encoding: schema: type: string example: chunked Connection: schema: type: string example: keep-alive Server: schema: type: string example: cloudflare Nel: schema: type: string example: '{"report_to":"cf-nel","success_fraction":0.0,"max_age":604800}' Vary: schema: type: string example: Origin X-Content-Type-Options: schema: type: string example: nosniff Referrer-Policy: schema: type: string example: same-origin Cross-Origin-Opener-Policy: schema: type: string example: same-origin cf-cache-status: schema: type: string example: DYNAMIC Report-To: schema: type: string example: >- {"group":"cf-nel","max_age":604800,"endpoints":[{"url":"https://a.nel.cloudflare.com/report/v4?s=dRBpQ7eFEK2wMpvp9GV9ABF8mIr%2BTY0wWlixqsCsm5ccOvvUWwR2Yw%2FcfwkLVO%2BVt5WQg5%2BwV%2BqQin9g%2FvE%2BHZxeNoJjaQ47PZem1u0rXk7l350gfrL6rawOpyv9RsY%3D"}]} CF-RAY: schema: type: string example: 9b90f90aac2d21b6-GDL alt-svc: schema: type: string example: h3=":443"; ma=86400 '403': description: 403 Forbidden headers: Date: schema: type: string example: Mon, 05 Jan 2026 06:53:52 GMT Transfer-Encoding: schema: type: string example: chunked Connection: schema: type: string example: keep-alive Server: schema: type: string example: cloudflare Nel: schema: type: string example: '{"report_to":"cf-nel","success_fraction":0.0,"max_age":604800}' Vary: schema: type: string example: Accept, Accept-Language, Origin Allow: schema: type: string example: GET, HEAD, OPTIONS Content-Language: schema: type: string example: es-mx X-Frame-Options: schema: type: string example: DENY X-Content-Type-Options: schema: type: string example: nosniff Referrer-Policy: schema: type: string example: same-origin Cross-Origin-Opener-Policy: schema: type: string example: same-origin cf-cache-status: schema: type: string example: DYNAMIC Report-To: schema: type: string example: >- {"group":"cf-nel","max_age":604800,"endpoints":[{"url":"https://a.nel.cloudflare.com/report/v4?s=MsSOiElBXdy7egeMjf5EHJJ3vVtuNtAFQJy8bXY7AuafZga5R4wSidRB0SGG8hq6DBr3vIS%2FvEl14nwa0nlDtpxvOb5FQJkVfaemyFOgRmdbxSapopwhLroYefpi8Ko%3D"}]} Content-Encoding: schema: type: string example: br CF-RAY: schema: type: string example: 9b910f9e8aaa219e-GDL alt-svc: schema: type: string example: h3=":443"; ma=86400 content: application/json: schema: type: object properties: error: type: object properties: code: type: string message: type: string details: nullable: true transaction_id: type: string example: error: code: USER_INACTIVE_ERROR message: >- Lo sentimos no puedes realizar esta acción debido a que tu cuenta no esta activa, favor de contactar a tu asesor. details: null transaction_id: 2aefad11-a0f6-4c7d-9601-fdc03309faaf '404': description: 404 Not Found headers: Date: schema: type: string example: Tue, 06 Jan 2026 04:56:02 GMT Content-Length: schema: type: integer example: 229 Connection: schema: type: string example: keep-alive Server: schema: type: string example: cloudflare Nel: schema: type: string example: '{"report_to":"cf-nel","success_fraction":0.0,"max_age":604800}' Vary: schema: type: string example: Accept, Accept-Language, Origin Allow: schema: type: string example: POST, OPTIONS Content-Language: schema: type: string example: es-mx X-Frame-Options: schema: type: string example: DENY X-Content-Type-Options: schema: type: string example: nosniff Referrer-Policy: schema: type: string example: same-origin Cross-Origin-Opener-Policy: schema: type: string example: same-origin cf-cache-status: schema: type: string example: DYNAMIC Report-To: schema: type: string example: >- {"group":"cf-nel","max_age":604800,"endpoints":[{"url":"https://a.nel.cloudflare.com/report/v4?s=pLvgafO2J75g%2FYyQ4aZ30ln6B6%2FLHXgHDme5nzSYrdU75vXBvqz6EQ1yBFFA5gaqKofrtJvDNtVOIbTQl4dFrEG%2B8mPrqXlq%2FDTUs3nxlnopl%2BtnN3zi5NmMam0nrU0%3D"}]} CF-RAY: schema: type: string example: 9b98a0627db221a7-GDL alt-svc: schema: type: string example: h3=":443"; ma=86400 content: application/json: schema: type: object properties: error: type: object properties: code: type: string message: type: string details: nullable: true transaction_id: type: string example: error: code: SERVICE_ERROR_NO_FOUND message: >- Lo sentimos no hay servicios disponibles con los datos proporcionados, favor de contactar a tu asesor. details: null transaction_id: 13926026-3f5a-40e2-88cc-34414fec366d '405': description: 405 Method Not Allowed headers: Date: schema: type: string example: Mon, 05 Jan 2026 06:39:08 GMT Content-Length: schema: type: integer example: 61 Connection: schema: type: string example: keep-alive Server: schema: type: string example: cloudflare Nel: schema: type: string example: '{"report_to":"cf-nel","success_fraction":0.0,"max_age":604800}' Vary: schema: type: string example: Accept, Accept-Language, Origin Allow: schema: type: string example: GET, HEAD, OPTIONS Content-Language: schema: type: string example: es-mx X-Frame-Options: schema: type: string example: DENY X-Content-Type-Options: schema: type: string example: nosniff Referrer-Policy: schema: type: string example: same-origin Cross-Origin-Opener-Policy: schema: type: string example: same-origin cf-cache-status: schema: type: string example: DYNAMIC Report-To: schema: type: string example: >- {"group":"cf-nel","max_age":604800,"endpoints":[{"url":"https://a.nel.cloudflare.com/report/v4?s=I4j1kPsCKLZDVklcgrUsqrefv2Gpm3gGEY47AMMK83c7sZ%2BLLpfCYCQtwEFdEYGhURHwk4W6BPdD17RGoj7nR8g4lJDnfV2UM6f3nG0lGfhMM75rf9FzAGsqT9eJmq8%3D"}]} CF-RAY: schema: type: string example: 9b90fa0cd92321b6-GDL alt-svc: schema: type: string example: h3=":443"; ma=86400 content: application/json: schema: type: object properties: detail: type: string status_code: type: integer example: detail: Método "GET" no permitido. status_code: 405 '406': description: 406 Not Acceptable headers: Date: schema: type: string example: Tue, 06 Jan 2026 00:39:26 GMT Content-Length: schema: type: integer example: 240 Connection: schema: type: string example: keep-alive Server: schema: type: string example: cloudflare Nel: schema: type: string example: '{"report_to":"cf-nel","success_fraction":0.0,"max_age":604800}' Vary: schema: type: string example: Accept, Accept-Language, Origin Allow: schema: type: string example: POST, OPTIONS Content-Language: schema: type: string example: es-mx X-Frame-Options: schema: type: string example: DENY X-Content-Type-Options: schema: type: string example: nosniff Referrer-Policy: schema: type: string example: same-origin Cross-Origin-Opener-Policy: schema: type: string example: same-origin cf-cache-status: schema: type: string example: DYNAMIC Report-To: schema: type: string example: >- {"group":"cf-nel","max_age":604800,"endpoints":[{"url":"https://a.nel.cloudflare.com/report/v4?s=XtZ6t%2BUUgk4N4zbeIuR%2FvrpIaRjVfyKccHPdrEcTE81hJ2vlns7rx1Tj%2BqI5Nqa%2BIRAmHsqGvzkkwF09WFqFVLI2IiMHSgMVpt%2F47rQiGdxt%2FE16iFTVw09x80jkklA%3D"}]} CF-RAY: schema: type: string example: 9b9728832ce321b9-GDL alt-svc: schema: type: string example: h3=":443"; ma=86400 content: application/json: schema: type: object properties: error: type: object properties: code: type: string message: type: string details: type: object properties: origin: type: object properties: zip_code: type: array items: type: string transaction_id: type: string example: error: code: REQUEST_ERROR_406 message: Datos de la solicitud incompletos. details: origin: zip_code: - >- Asegúrese de que este campo no tenga más de 5 caracteres. transaction_id: 65e0f4c5-4c58-4f96-965b-4e2203973c13 '500': description: 500 Internal Server Error headers: Date: schema: type: string example: Tue, 06 Jan 2026 00:34:58 GMT Content-Length: schema: type: integer example: 228 Connection: schema: type: string example: keep-alive Server: schema: type: string example: cloudflare Nel: schema: type: string example: '{"report_to":"cf-nel","success_fraction":0.0,"max_age":604800}' Vary: schema: type: string example: Accept, Accept-Language, Origin Allow: schema: type: string example: GET, HEAD, OPTIONS Content-Language: schema: type: string example: es-mx X-Frame-Options: schema: type: string example: DENY X-Content-Type-Options: schema: type: string example: nosniff Referrer-Policy: schema: type: string example: same-origin Cross-Origin-Opener-Policy: schema: type: string example: same-origin cf-cache-status: schema: type: string example: DYNAMIC Report-To: schema: type: string example: >- {"group":"cf-nel","max_age":604800,"endpoints":[{"url":"https://a.nel.cloudflare.com/report/v4?s=5wNp833rxG7t4oYqrtaBZ%2BAZ%2BohCFqSzrvgNCXEvbO6IZY2v8yiXIe7Jtp%2FPz2wcdQRWcpkq0UulWuyJiYMIzMuwqzMH3nxRhehooYGjMLJyKn5bCk1IzMx3aa4kZmE%3D"}]} CF-RAY: schema: type: string example: 9b9721f7687821b2-GDL alt-svc: schema: type: string example: h3=":443"; ma=86400 content: application/json: schema: type: object properties: error: type: object properties: code: type: string message: type: string details: nullable: true transaction_id: type: string example: error: code: INTERNAL_SERVER_ERROR message: >- Lo sentimos hubo un error inesperado, favor de intentar mas tarde. details: null transaction_id: 9f091a8a-a214-4c23-8b89-560670c64714 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.