Cotiza un envío
Envíopack te permite cotizar el valor de un envío con una amplia variedad de empresas de correo de 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 su volumen. 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 fórmula 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 el 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í | Numero | Entero de 4 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 más de un bulto se deben sumar los volúmenes de dichos bultos. Este parámetro queda deprecado en favor del 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 será más precisa. Ej. Andreani solo permite despachar un único bulto por envío o etiqueta. En caso de no recibir valor alguno, nuestro sistema asume por default el envío de un único bulto. Este parámetro queda deprecado en favor del uso del nuevo parámetro paquetes. |
| paquetes | No | string |
Este parámetro espera un formato especial que indique las dimensiones de los N paquetes que pueda tener el envío a cotizar.
Ejemplo: 20x2x10,20x2x10 indica que se envían 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 envío de un único 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 logístico debe retirar el paquete desde el depósito 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 pasará a retirar la mercadería a enviar.
Podes obtenerlo ingresando en Configuración / Mis Depósitos. Si bien este parámetro no es obligatorio, es conveniente enviarlo, pues de esta manera la cotización será más precisa. En caso de no recibir valor alguno, nuestro sistema asume que el envío se realizará desde la dirección de envío default. Si no existiera una dirección de envío default no será posible devolver cotizaciones y el webservice no informará 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 envíos de similares características - anomalos: para ordenar por porcentaje de anómalos en envíos de similares caracteristicas |
| orden_sentido | No | String |
Los valores posibles son:
- asc: para orden ascendente (Default) - desc: para orden descendente |
| empresa | No | ID | En los casos en donde se quiera cotizar un pedido que proviene de un market, se debe enviar como parámetro el id de la empresa a la cual pertenece el pedido.(Para las cotizaciones de este tipo de pedidos se deben autenticar con las credenciales del market) |
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.enviopack.com/cotizar/costo?access_token=[TU_ACCESS_TOKEN]
&provincia=C
&codigo_postal=1405
&peso=1.5
&paquetes=20x3x5
&direccion_envio=22'
&empresa=2234'RESPONSE
[
{
"correo":
{
"id":"oca",
"nombre":"OCA"
},
"despacho":"D",
"modalidad":"S",
"servicio":"N",
"peso_desde":"1.00",
"peso_hasta":"2.00",
"valor":"44.85",
"horas_entrega":72,
"cumplimiento":94
"anomalos":5
},
{
"correo":
{
"id":"oca",
"nombre":"OCA"
},
"despacho":"S",
"modalidad":"S",
"servicio":"N",
"peso_desde":"1.00",
"peso_hasta":"2.00",
"valor":"44.85",
"horas_entrega":72,
"cumplimiento":94
"anomalos":5
},
{
"correo":
{
"id":"urbano",
"nombre":"Urbano"
},
"despacho":"D",
"modalidad":"D",
"servicio":"N",
"peso_desde":"1.00",
"peso_hasta":"3.00",
"valor":"47.39",
"horas_entrega":72,
"cumplimiento":85
"anomalos":2
},
{...},
{
"correo":
{
"id":"fastmail",
"nombre":"Fast Mail"
},
"despacho":"D",
"modalidad":"D",
"servicio":"N",
"peso_desde":"0.00",
"peso_hasta":"2.00",
"valor":"55.66",
"horas_entrega":72,
"cumplimiento":97
"anomalos":20
}
]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 el 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. Los IDs de provincias están bajo el estándar ISO_3166-2:AR sin el prefijo AR-. |
| codigo_postal | Sí | Numero | Entero de 4 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 envío a cotizar.
Ejemplo: 20x2x10,20x2x10 indica que se envían 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 envío de un único 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.enviopack.com/cotizar/precio/a-domicilio?access_token=[TU_ACCESS_TOKEN]
&provincia=C
&codigo_postal=1414
&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 además toda la información de cada sucursal elegible.
Este webservice está diseñado para que tu comprador, en el checkout de tu aplicación, pueda cotizar y elegir en tiempo real en qué 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. Los IDs de provincias están bajo el estándar ISO_3166-2:AR sin el prefijo AR-. |
| 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 más de un bulto se deben sumar los volúmenes de dichos bultos. Este parámetro queda deprecado en favor del 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 será más precisa. Ejemplo: Andreani solo permite despachar un único bulto por envío o etiqueta. En caso de no recibir valor alguno, nuestro sistema asume por default el envío de un único bulto. Este parámetro queda deprecado en favor del 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 envío a cotizar.
Ejemplo: 20x2x10,20x2x10 indica que se envían 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 envío de un único 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 pasará a retirar la mercadería a enviar.
Podes obtenerlo ingresando en Configuración / Depósitos. 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 envío default. Si no existiera una dirección de envío default no será posible devolver cotizaciones y el webservice no informará resultados. |
Ejemplo
REQUEST
curl -X GET \
'https://api.enviopack.com/cotizar/precio/a-sucursal?access_token=[TU_ACCESS_TOKEN]
&provincia=C
&localidad=137
&peso=1
&paquetes=20x3x5,5x20x10
&correo=andreani
&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: "Av. Corrientes",
codigo: "MIC",
codigo_postal: "1043",
correo: {
id: "andreani",
nombre: "Andreani"
},
horario: "Lunes a Viernes de 9:00 a 18:00 hs. | Sbado de 9:00 a 13:00 hs",
id: 598,
latitud: "-34.602921",
longitud: "-58.373278",
nombre: "Microcentro",
numero: "455",
telefono: "0810-122-1111",
localidad: {
id: 137,
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: "Talcahuano",
codigo: "TRI",
codigo_postal: "1013",
correo: {
id: "andreani",
nombre: "Andreani"
},
horario: "De Lunes a Viernes de 08:30 a 17:30",
id: 139,
latitud: "-34.603083",
longitud: "-58.385185",
nombre: "Tribunales",
numero: "470",
telefono: "0810-122-1111",
localidad: {
id: 137,
nombre: "Centro"
}
},
valor: "98.00"
}
]