Cotiza y emite tu primera guía

Para comenzar a cotizar envíos con todas las paqueterías activas en Manuable, utiliza el endpoint de API: api/rates. Este servicio te devolverá múltiples opciones de cotización, cada una identificada por un UUID único, que luego se utilizará para procesar la emisión del envío.

Paqueterías activas

Actualmente, los servicios de mensajería disponibles para cotización y generación de guías son: FedEx, DHL, UPS y Sendex.

Cotiza

Parámetros de solicitud (Request)

Cada solicitud de cotización requiere los siguientes parámetros para definir tanto la dirección de origen y destino como las características del paquete.

RateRequest

POST Body para obtener cotizaciones

address_from

required

Any of

Address

Esquema de una dirección

Example:

{"country_code":"MX","zip_code":"66058"}

country_code

string

required

Código de país

Example:

zip_code

string

required

Código postal

Example:

66058

address_to

required

Any of

Address

Esquema de una dirección

Example:

{"country_code":"MX","zip_code":"66058"}

country_code

string

required

Código de país

Example:

zip_code

string

required

Código postal

Example:

66058

parcel

required

Any of

Parcel

Esquema de un paquete

Example:

{"currency":"MXN","distance_unit":"CM","height":10,"length":10,"mass_unit":"KG","product_id":"01010101","product_value":4321,"quantity_products":1,"reason_code":"GIFT","weight":10,"width":10}

currency

string

required

Moneda del valor del producto

Example:

MXN

distance_unit

string

required

Unidad de medida de distancia

Example:

height

number

required

Alto del paquete

>= 1

Example:

length

number

required

Largo del paquete

>= 1

Example:

mass_unit

string

required

Unidad de medida de peso

Example:

product_id

string

required

ID del producto

Example:

01010101

product_value

number

required

Valor del producto (valor mínimo de 1)

>= 1

Example:

4321

quantity_products

integer

required

Cantidad de productos

Example:

content

string

required

Contenido

Example:

GIFT

weight

number

required

Peso del paquete

>= 1

Example:

width

number

required

Ancho del paquete

>= 1

Example:

Solicitud (Request)

Aviso!

En caso de que el peso indicado incluya decimales, se redondeará al siguiente kilogramo entero. Por ejemplo, si se cotiza un envío de 1.1 kg, se tomará como 2 kg para efectos de cálculo.

Respuesta (Response)

La API devolverá una lista de opciones de envío con detalles como la paquetería, servicio, y monto total. Cada cotización incluye un UUID único, necesario para la etapa de emisión:

El UUID de la cotización encapsula toda la información requerida del servicio, por lo que no es necesario reenviar los datos previamente proporcionados al utilizar el endpoint de emisión.

Emite

Una vez que hayas seleccionado una cotización, utiliza el endpoint correspondiente para emitir la guía y confirmar el envío. Esta solicitud requiere la información del origen y destino, así como los detalles del paquete y el rate_token obtenido durante la etapa de cotización.

Para evitar errores en la emision se recomienda revisar algunas de la restricciones a considerar en el apartado Limitantes por Paquetería.

Solicitud (Request)

** Te recomendamos consultar el Catálogo de Productos del SAT para seleccionar el identificador correspondiente al tipo de producto que estás enviando.

Respuesta (Response)

Una vez realizada la emisión, la API devuelve la información completa del envío, incluyendo el tracking number y el enlace para descargar la guía:

Cotiza y emite tu primera guía

Cotiza#

Parámetros de solicitud (Request)#

Solicitud (Request)#

Respuesta (Response)#

Emite#

Solicitud (Request)#

Respuesta (Response)#

Cotiza

Parámetros de solicitud (Request)

Solicitud (Request)

Respuesta (Response)

Emite

Solicitud (Request)

Respuesta (Response)