EnvioPack

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	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 caracteres (puede comenzar con 0)
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.
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-cl.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"
		},
		"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 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í	String	String de 5 caracteres (puede comenzar con 0)
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-cl.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	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 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-cl.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"
	}
]

Recursos

Cotiza un envío

Peso Aforado

Obtener el costo que abona el vendedor por el envío

GET /cotizar/costo

Listado de parámetros

Ejemplo

Obtener el precio que abona el comprador por el envío a domicilio

GET /cotizar/precio/a-domicilio

Listado de parámetros

Ejemplo

Obtener el precio que abona el comprador por el envío a una sucursal

GET /cotizar/precio/a-sucursal

Listado de parámetros

Ejemplo