Cotiza un envío

EnvioPack 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.
EnvioPack 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 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 Numero Entero de 4 dígitos
peso 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.
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.enviopack.com/cotizar/costo?access_token=[TU_ACCESS_TOKEN]
	  &provincia=C
	  &codigo_postal=1405
	  &peso=1.5
	  &paquetes=20x3x5
	  &direccion_envio=22'
RESPONSE

[
	{
		"correo":
		{
			"id":"oca",
			"nombre":"OCA"
		},s
		"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"
		},s
		"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 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 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 Numero Entero de 4 dígitos
peso 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.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 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 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 ID Deberá informarse el valor ID devuelto por el webservice de localidades.
peso 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.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"
	}
]