Cotiza un envío
Envíopack te permite cotizar el valor de un envío con una amplia cantidad de empresas de correo de una forma simple y estandarizada.
Peso Aforado
Antes de solicitar tu primera cotización es importante comprender el concepto de Peso Aforado.
Las empresas de correo brindan su cotización teniendo en cuenta no solo el peso del paquete a enviar,
sino también el volumen del mismo. El concepto de peso aforado ayuda a las empresas de correo
a parametrizar el costo de enviar un kilo de plumas vs un kilo de acero, dado que si bien ambos pesan lo mismo su volumen difiere drásticamente.
No existe una formula universal a la hora de aforar un paquete, de hecho cada correo tiene la suya.
Envíopack te permite abstraerte de esta situación ya que nosotros nos ocupamos
de aforar tus paquetes según la regla de cada correo.
Por tal motivo, para una mayor certeza en la cotización es importante no solo informar el peso del envío, sino también el volumen del mismo.
Obtener el costo que abona el vendedor por el envío
GET /cotizar/costo
Permite obtener un listado de cotizaciones brindando en cada una de ellas el valor que vendedor va a pagar por el envío:
Listado de parámetros
| Parámetro | ¿Es Obligatorio? | Tipo de Dato | Observaciones |
|---|---|---|---|
| provincia | Sí | ID | Deberá informarse el valor ID devuelto por el webservice de provincias. Los IDs de provincias están bajo el estándar ISO_3166-2:AR sin el prefijo AR-. |
| codigo_postal | Sí | String | String de 5 dígitos |
| peso | Sí | Numero | Hasta 2 dígitos decimales |
| volumen | No | Numero |
Hasta 2 dígitos decimales.
El volumen se calcula como (Alto x Ancho x Largo ). En caso de cotizar un envío con mas de un bulto se deben sumarse los volúmenes dichos bultos. Este parámetro queda deprecado en favor de el uso del nuevo parámetro paquetes |
| class="notranslate"bultos | No | Numero |
Entero, sin dígitos decimales.
Si bien este parámetro no es obligatorio es conveniente enviarlo, pues de esta manera la cotización sera más precisa. Ej. Andreani solo permite despachar un unico bulto por envio o etiqueta. En caso de no recibir valor alguno, nuestro sistema asume por default el envio de un unico bulto Este parámetro queda deprecado en favor de el uso del nuevo parámetro paquetes |
| paquetes | No | string |
Este parámetro espera un formato especial el cual debe indicar las dimensiones de los N paquetes que pueda tener el envio a cotizar.
Ej: 20x2x10,20x2x10 indica que se envian 2 paquetes y cada uno tiene 20 cm de alto x 2 cm de ancho x 10 cm de largo. En caso de no recibir valor alguno, nuestro sistema asume por default el envio de un unico paquete de 1 x 1 x 1. |
| correo | No | ID |
Deberá informarse el valor ID devuelto por el webservice de correos.
Por ejemplo para FastMail su ID es fastmail. |
| despacho | No | String |
Indica si el operador logistico debe retirar el paquete por el deposito del vendedor o si el vendedor lo va a acercar a una sucursal.
Los valores posibles son: - D: retiro por domicilio - S: despacho desde sucursal |
| modalidad | No | String |
Los valores posibles son:
- D: para envíos a domicilio - S: para envíos a sucursal |
| servicio | No | String |
Los valores posibles son:
- N: para el servicio estándar - P: para el servicio prioritario - X: para el servicio express - R: para el servicio de devoluciones |
| direccion_envio | No | ID |
ID que identifica la dirección, por donde el correo pasara a retirar la mercadería a enviar.
Podes obtenerlo ingresando en Configuración / Mis Direcciones Si bien este parámetro no es obligatorio es conveniente enviarlo, pues de esta manera la cotización sera más precisa. En caso de no recibir valor alguno, nuestro sistema asume que el envío se realizará desde la dirección de envio default. Si no existiera una dirección de envio default no sera posible devolver cotizaciones y el WS no informara resultados. |
| orden_columna | No | String |
Los valores posibles son:
- valor: para ordenar por precio (Default) - horas_entrega: para ordenar por velocidad de envío - cumplimiento: para ordenar por porcentaje de cumplimiento en envios de similares caracteristicas - anomalos: para ordenar por porcentaje de anómalos en envios de similares caracteristicas |
| orden_sentido | No | String |
Los valores posibles son:
- asc: para orden ascendente (Default) - desc: para orden descendente |
Las cotizaciones de costos se realizan siempre por código postal, de manera que si querés obtener la cotización para una sucursal en particular tendrás que utilizar primero el webservice de sucursales para obtener el código postal de la misma sobre el cual cotizar.
Ejemplo
REQUEST
curl -X GET \
'https://api-mx.enviopack.com/cotizar/costo?access_token=[TU_ACCESS_TOKEN]
&provincia=C
&codigo_postal=01000
&peso=1.5
&paquetes=20x3x5
&direccion_envio=22'RESPONSE
[
{
"correo": {
"id": "cargamos",
"nombre": "Cargamos",
"tiene_sucursales": false,
"requiere_remito_legal": false,
"permite_usar_seguro": false,
"usa_distribucion_enviopack": true
},
"despacho": "D",
"modalidad": "D",
"servicio": "N",
"peso_desde": "9.00",
"peso_hasta": "10.00",
"valor": 103,
"horas_entrega": 48,
"valor_colecta": 22,
"valor_distribucion": 81
},
{
"correo": {
"id": "logispack",
"nombre": "Logispack",
"tiene_sucursales": false,
"requiere_remito_legal": false,
"permite_usar_seguro": false,
"usa_distribucion_enviopack": true
},
"despacho": "D",
"modalidad": "D",
"servicio": "N",
"peso_desde": "9.00",
"peso_hasta": "10.00",
"valor": 126,
"horas_entrega": 24,
"valor_colecta": 22,
"valor_distribucion": 104
},
{
"correo": {
"id": "ivoy",
"nombre": "Ivoy",
"tiene_sucursales": false,
"requiere_remito_legal": false,
"permite_usar_seguro": true,
"usa_distribucion_enviopack": true
},
"despacho": "D",
"modalidad": "D",
"servicio": "N",
"peso_desde": "9.00",
"peso_hasta": "10.00",
"valor": 130,
"horas_entrega": 48,
"valor_colecta": 22,
"valor_distribucion": 108
},
{
"correo": {
"id": "chazki",
"nombre": "Chazki",
"tiene_sucursales": false,
"requiere_remito_legal": false,
"permite_usar_seguro": false,
"usa_distribucion_enviopack": true
},
"despacho": "D",
"modalidad": "D",
"servicio": "N",
"peso_desde": "9.00",
"peso_hasta": "10.00",
"valor": 161.2,
"horas_entrega": 96,
"valor_colecta": 22,
"valor_distribucion": 139.2
},
{
"correo": {
"id": "redpack",
"nombre": "Redpack",
"tiene_sucursales": false,
"requiere_remito_legal": false,
"permite_usar_seguro": false,
"usa_distribucion_enviopack": true
},
"despacho": "D",
"modalidad": "D",
"servicio": "N",
"peso_desde": "9.00",
"peso_hasta": "10.00",
"valor": 172,
"horas_entrega": 72,
"valor_colecta": 22,
"valor_distribucion": 150
},
{
"correo": {
"id": "fedex",
"nombre": "Fedex",
"tiene_sucursales": true,
"requiere_remito_legal": false,
"permite_usar_seguro": true,
"usa_distribucion_enviopack": true
},
"despacho": "D",
"modalidad": "D",
"servicio": "N",
"peso_desde": "5.00",
"peso_hasta": "10.00",
"valor": 218.7,
"horas_entrega": 72,
"valor_colecta": 22,
"valor_distribucion": 196.7
},
{
"correo": {
"id": "noventaynueveminutos",
"nombre": "99 Minutos",
"tiene_sucursales": false,
"requiere_remito_legal": false,
"permite_usar_seguro": false,
"usa_distribucion_enviopack": true
},
"despacho": "D",
"modalidad": "D",
"servicio": "N",
"peso_desde": "9.00",
"peso_hasta": "10.00",
"valor": 302,
"horas_entrega": 49,
"valor_colecta": 22,
"valor_distribucion": 280
},
{
"correo": {
"id": "redpack_ltl",
"nombre": "Redpack LTL",
"tiene_sucursales": false,
"requiere_remito_legal": false,
"permite_usar_seguro": false,
"usa_distribucion_enviopack": true
},
"despacho": "D",
"modalidad": "D",
"servicio": "N",
"peso_desde": "9.00",
"peso_hasta": "10.00",
"valor": 452,
"horas_entrega": 72,
"valor_colecta": 22,
"valor_distribucion": 430
},
{
"correo": {
"id": "fedex_ltl",
"nombre": "Fedex LTL",
"tiene_sucursales": false,
"requiere_remito_legal": false,
"permite_usar_seguro": true,
"usa_distribucion_enviopack": true
},
"despacho": "D",
"modalidad": "D",
"servicio": "N",
"peso_desde": "0.00",
"peso_hasta": "70.00",
"valor": 1550,
"horas_entrega": 192,
"valor_colecta": 65,
"valor_distribucion": 1485
}
]Obtener el precio que abona el comprador por el envío a domicilio
GET /cotizar/precio/a-domicilio
Permite obtener un listado de cotizaciones brindando en cada una de ellas el valor que comprador va a pagar por el envío a domicilio.
Los valores devueltos por este webservice pueden ser modificados desde la sección correos y tarifas para cada servicio en particular.
Listado de parámetros
| Parámetro | ¿Es Obligatorio? | Tipo de Dato | Observaciones |
|---|---|---|---|
| provincia | Sí | ID | Deberá informarse el valor ID devuelto por el webservice de provincias. |
| codigo_postal | Sí | String | Contiene 5 dígitos |
| peso | Sí | Numero | Hasta 2 dígitos decimales |
| paquetes | No | string |
Este parámetro espera un formato especial el cual debe indicar las dimensiones de los N paquetes que pueda tener el envio a cotizar.
Ej: 20x2x10,20x2x10 indica que se envian 2 paquetes y cada uno tiene 20 cm de alto x 2 cm de ancho x 10 cm de largo. En caso de no recibir valor alguno, nuestro sistema asume por default el envio de un unico paquete de 1 x 1 x 1. |
| servicio | No | String |
Los valores posibles son:
- N: para el servicio estándar - P: para el servicio prioritario - X: para el servicio express - R: para el servicio de devoluciones |
Ejemplo
REQUEST
curl -X GET \
'https://api-mx.enviopack.com/cotizar/precio/a-domicilio?access_token=[TU_ACCESS_TOKEN]
&provincia=CX
&codigo_postal=01000
&peso=1.598
&paquetes=20x2x10'RESPONSE
[
{
modalidad":"D",
"servicio":"N",
"peso_desde":"1.00",
"peso_hasta":"2.00",
"valor":"80.00",
"horas_entrega": 96
},
{
"modalidad":"D",
"servicio":"P",
"peso_desde":"1.00",
"peso_hasta":"2.00",
"valor":"120.00",
"horas_entrega": 24
}
]Obtener el precio que abona el comprador por el envío a una sucursal
GET /cotizar/precio/a-sucursal
Permite obtener un listado de cotizaciones brindando en cada una de ellas el valor que el comprador va a pagar por un envío a sucursal, retornando ademas toda la información de cada sucursal elegible.
Este webservice esta diseñado para que tu comprador en el checkout de tu aplicación pueda cotizar y elegir en tiempo real en que sucursal quiere recibir su pedido.
Los valores devueltos por este webservice pueden ser modificados desde la sección correos y tarifas para cada correo en particular.
Listado de parámetros
| Parámetro | ¿Es Obligatorio? | Tipo de Dato | Observaciones |
|---|---|---|---|
| provincia | Sí | ID | Deberá informarse el valor ID devuelto por el webservice de provincias. |
| localidad | Sí | ID | Deberá informarse el valor ID devuelto por el webservice de localidades. |
| peso | Sí | Numero | Hasta 2 dígitos decimales |
| volumen | No | Numero |
Hasta 2 dígitos decimales.
El volumen se calcula como (Alto x Ancho x Largo ). En caso de cotizar un envío con mas de un bulto se deben sumarse los volúmenes dichos bultos. Este parámetro queda deprecado en favor de el uso del nuevo parámetro paquetes |
| bultos | No | Numero |
Entero, sin dígitos decimales.
Si bien este parámetro no es obligatorio es conveniente enviarlo, pues de esta manera la cotización sera más precisa. Ej. Andreani solo permite despachar un unico bulto por envio o etiqueta. En caso de no recibir valor alguno, nuestro sistema asume por default el envio de un unico bulto Este parámetro queda deprecado en favor de el uso del nuevo parámetro paquetes |
| paquetes | No | string |
Este parámetro espera un formato especial el cual debe indicar las dimensiones de los N paquetes que pueda tener el envio a cotizar.
Ej: 20x2x10,20x2x10 indica que se envian 2 paquetes y cada uno tiene 20 cm de alto x 2 cm de ancho x 10 cm de largo. En caso de no recibir valor alguno, nuestro sistema asume por default el envio de un unico paquete de 1 x 1 x 1. |
| correo | No | ID |
Deberá informarse el valor ID devuelto por el webservice de correos.
Por ejemplo para FastMail su ID es fastmail. |
| direccion_envio | No | ID |
ID que identifica la dirección, por donde el correo pasara a retirar la mercadería a enviar.
Podes obtenerlo ingresando en Configuración / Mis Direcciones Si bien este parámetro no es obligatorio es conveniente enviarlo, pues de esta manera la cotización sera más precisa. En caso de no recibir valor alguno, nuestro sistema asume que el envío se realizará desde la dirección de envio default. Si no existiera una dirección de envio default no sera posible devolver cotizaciones y el WS no informara resultados. |
Ejemplo
REQUEST
curl -X GET \
'https://api-mx.enviopack.com/cotizar/precio/a-sucursal?access_token=[TU_ACCESS_TOKEN]
&provincia=CX
&localidad=10
&peso=1
&paquetes=20x3x5,5x20x10
&correo=fedex
&direccion_envio=268'RESPONSE
[
{
anomalos: 0,
cumplimiento: 98,
horas_entrega: 72,
modalidad: "S",
peso_desde: "1.00",
peso_hasta: "2.00",
servicio: "N",
sucursal: {
calle: "Hegel 406",
codigo: "123",
codigo_postal: "1043",
correo: {
id: "fedex",
nombre: "Fedex"
},
horario: "Lunes a Viernes de 9:00 a 18:00 hs. | Sábado de 9:00 a 13:00 hs",
id: 598,
latitud: "-34.602921",
longitud: "-58.373278",
nombre: "Centro de Envio FedEx",
numero: "406",
telefono: "+52 55 5531 6488",
localidad: {
id: 10,
nombre: "Centro"
}
},
valor: "98.00"
},
{...},
{
anomalos: 10,
cumplimiento: 95,
horas_entrega: 72,
modalidad: "S",
peso_desde: "1.00",
peso_hasta: "2.00",
servicio: "N",
sucursal: {
calle: "Canal de Miramontes",
codigo: "321",
codigo_postal: "1013",
correo: {
id: "fedex",
nombre: "Fedex"
},
horario: "De Lunes a Viernes de 08:30 a 17:30",
id: 139,
latitud: "-34.603083",
longitud: "-58.385185",
nombre: "Centro Miramontes",
numero: "3193",
telefono: "0810-122-1111",
localidad: {
id: 10,
nombre: "Centro"
}
},
valor: "98.00"
}
]