API > Return API

Una llamada a la API para crear las etiquetas de devolución

Return API te permite crear etiquetas de devolución en el momento en el que tu cliente lo solicita. ¡Solo necesitas una llamada API para todos tus transportistas!

Empieza ya tu prueba gratis de 30 pedidos.
No tienes que introducir tu tarjeta de crédito.

130+

integraciones de transportistas
disponibles

Una

API para todos
tus transportistas

Uptime

garantizado

Qué puedes hacer
con Return API

Nuestras API están diseñadas para potenciar tu ecosistema actual. Por eso pueden usarse para acelerar diferentes flujos de envío.

Crea devoluciones para tus envíos tan pronto como tus clientes lo soliciten

Con Return API puedes crear etiquetas de devolución para los envíos en segundos. Así la gestión del proceso de devolución es rápida, tanto para ti como para tus clientes.

¿Necesitas optimizar todo el proceso de devolución? Prueba ShippyPro <a href='https://www.shippypro.com/easy-return.html' class='c-violet stdBold' title='Easy Return'>Easy Return</a>

¿Necesitas optimizar todo el proceso de devolución? Prueba ShippyPro Easy Return

Easy Return de ShippyPro es la solución perfecta para ofrecer una experiencia de devolución optimizada para tus clientes. Usa la plataforma de ShippyPro para crear un portal de devolución que esté listo para usarse y que se añadirá en tu web en pocos pasos. Automatiza la implementación de tu política de devoluciones y haz que las devoluciones sean fáciles y rápidas, tanto para ti como para tus clientes.

Descubre Return API

Echa un vistazo a la solicitud y respuesta de Return API y visita nuestra documentación API para empezar. Nuestras API están escritas en 14 lenguajes de programación y en dos tecnologías diferentes, REST y SOAP.

REST

SOAP

Con solo un campo más "IsReturn", podrás generar una etiqueta de devolución en lugar de una etiqueta de envío. El resto de la llamada es igual a la Shipping API.

Solicitud

Respuesta

{
	"Method": "Ship",
	"Params": {
		"to_address": {
			"name": "John Doe",
			"company": "",
			"street1": "123 Main St",
			"street2": "",
			"city": "Park City",
			"state": "UT",
			"zip": "84060",
			"country": "US",
			"phone": "5551231234",
			"email": "johndoe@gmail.com"
		},
		"from_address": {
			"name": "John Doe",
			"company": "",
			"street1": "123 Main St",
			"street2": "",
			"city": "Park City",
			"state": "UT",
			"zip": "84060",
			"country": "US",
			"phone": "5551231234",
			"email": "johndoe@gmail.com"
		},
		"parcels": [
			{
				"length": 5,
				"width": 5,
				"height": 5,
				"weight": 10
			}
		],
		"TotalValue": "123 EUR",
		"TransactionID": "ORDER2365",
		"ContentDescription": "Milk",
		"Insurance": 0,
		"InsuranceCurrency": "EUR",
		"CashOnDelivery": 0,
		"CashOnDeliveryCurrency": "EUR",
		"CashOnDeliveryType": 0,
		"CarrierName": "DHLExpress",
		"CarrierService": "EXPRESS DOMESTIC",
		"CarrierID": 23,
		"OrderID": "12345",
		"RateID": "",
		"Incoterm": "DAP",
		"BillAccountNumber": "",
		"PaymentMethod": "Paypal",
		"Note": "Ship by 25/06/2018",
		"Async": false,
		"IsReturn": true,
	}
}

Respuesta

{
	"Result": "OK",
	"NewOrderID": "1234567",
	"LabelURL": [
		"https://cdn.shippypro.com/labels/label-u2504n6612345-15640512345.zpl",
		"https://cdn.shippypro.com/labels/label-u2504n6612345-commercialinvoice-15640512346.zpl"
	],
	"PDF": [],
	"ZPL": [
		"myzpllabel1...",
		"myzpllabel2..."
	],
	"TrackingCarrier": "SpringXBS",
	"TrackingNumber": "UD26123123456",
	"TrackingExternalLink": "https://mailingtechnology.com/tracking/?tn=UD26123123456",
	"AdditionalTrackingNumbers": [],
	"Status": "1"
}

<?xml version="1.0" encoding="UTF-8"?>
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
	<Body xmlnxsi="http://www.w3.org/2001/XMLSchema-instance" xmlnxsd="http://www.w3.org/2001/XMLSchema">
		<Ship xmlns="http//www.shippypro.com">
			<to_address xmlns="">
				<name>John Doe</name>
				<company>ShippyPro</company>
				<street1>123 Main St</street1>
				<street2 />
				<city>Park City</city>
				<state>UT</state>
				<zip>84060</zip>
				<country>US</country>
				<phone>5551231234</phone>
				<email>johndoe@gmail.com</email>
			</to_address>
			<from_address xmlns="">
				<name>John Doe</name>
				<company>ShippyPro</company>
				<street1>123 Main St</street1>
				<street2 />
				<city>Park City</city>
				<state>UT</state>
				<zip>84060</zip>
				<country>US</country>
				<phone>5551231234</phone>
				<email>johndoe@gmail.com</email>
			</from_address>
			<parcels xmlns="">
				<length>5</length>
				<width>5</width>
				<height>5</height>
				<weight>10</weight>
			</parcels>
			<TotalValue xmlns="">123 EUR</TotalValue>
			<TransactionID xmlns="">ORDER2365</TransactionID>
			<ContentDescription xmlns="">Milk</ContentDescription>
			<Insurance xmlns="">0</Insurance>
			<InsuranceCurrency xmlns="">EUR</InsuranceCurrency>
			<CashOnDelivery xmlns="">0</CashOnDelivery>
			<CashOnDeliveryCurrency xmlns="" />
			<CarrierName xmlns="">DHLExpress</CarrierName>
			<CarrierService xmlns="">EXPRESS DOMESTIC</CarrierService>
			<CarrierID xmlns="">23</CarrierID>
			<OrderID xmlns="">12345</OrderID>
			<RateID xmlns="" />
			<Incoterm xmlns="">DAP</Incoterm>
			<BillAccountNumber xmlns="" />
			<Note xmlns="" />
			<PickNumber xmlns="">12345</PickNumber>
			<Async xmlns="">false</Async>
		</Ship>
	</Body>
</Envelope>

Respuesta

<?xml version="1.0" encoding="UTF-8"?>
<root>
	<AdditionalTrackingNumbers />
	<LabelURL>
		<element>https://cdn.shippypro.com/labels/label-u2504n6612345-15640512345.zpl</element>
		<element>https://cdn.shippypro.com/labels/label-u2504n6612345-commercialinvoice-15640512346.zpl</element>
	</LabelURL>
	<NewOrderID>1234567</NewOrderID>
	<PDF />
	<Result>OK</Result>
	<Status>1</Status>
	<TrackingCarrier>SpringXBS</TrackingCarrier>
	<TrackingExternalLink>https://mailingtechnology.com/tracking/?tn=UD26123123456</TrackingExternalLink>
	<TrackingNumber>UD26123123456</TrackingNumber>
	<ZPL>
		<element>myzpllabel1...</element>
		<element>myzpllabel2...</element>
	</ZPL>
</root>

Lee nuestra documentación API

Cómo integrar
Return API

Lee nuestra documentación API

Lee nuestra documentación API para conocer el funcionamiento de Return API.

Únete gratis a ShippyPro

Crea una cuenta gratis en ShippyPro para implementar la API.

Conecta a un
transportista en pocos clics

Conecta a un transportista para empezar a probar nuestras API. Aprende a hacerlo en pocos pasos here.

Obtén tu clave API

Empieza tu prueba gratuita del plan de rápido crecimiento para acceder a tu clave API.

Prueba todas nuestras API dentro de
nuestra consola API

Obtén tarifas de envío, crea etiquetas de envío, programa recogidas y más desde nuestra API Console.

Integra nuestras API
dentro de tu sistema

¡Ya puedes integrar nuestras API! Lee nuestros artículos del Centro de Ayuda para sacarle el máximo partido a las API de ShippyPro.

Lee nuestra documentación API

Lee nuestra documentación API para conocer el funcionamiento de Return API.

Únete gratis a ShippyPro

Crea una cuenta gratis en ShippyPro para implementar la API.

Conecta a un
transportista en pocos clics

Conecta a un transportista para empezar a probar nuestras API. Aprende a hacerlo en pocos pasos here.

Obtén tu clave API

Empieza tu prueba gratuita del plan de rápido crecimiento para acceder a tu clave API.

Prueba todas nuestras API dentro de
nuestra consola API

Obtén tarifas de envío, crea etiquetas de envío, programa recogidas y más desde nuestra API Console.

Integra nuestras API
dentro de tu sistema

¡Ya puedes integrar nuestras API! Lee nuestros artículos del Centro de Ayuda para sacarle el máximo partido a las API de ShippyPro.

¿Eres una empresa que busca una solución para mejorar tu proceso de envío?

HABLA CON NUESTROS EXPERTOS

API eficaces, herramientas eficientes
para administrarlas

¡Saca partido a tu integración API! Prueba tus API con transportistas reales antes de integrarlos, ve tus registros API y evita algunos errores con nuestras herramientas.

→ API Logs

•

Ve todos tus registros API y obtén información útil para cada llamada a la API.

•

Verifica la solicitud y la respuesta real de todas tus API.

← API Errors

•

Obtén ayuda en tiempo real y de forma automática si algo sale mal.

•

Aprende cómo mejorar la gestión de tus API de un vistazo.

→ API Console

•

Conecta tus transportistas y prueba las API de ShippyPro en tiempo real. Obtén una respuesta inmediata.

•

Así sabrás exactamente cómo funciona cada API antes de integrarla.

← Webhook Logs

•

Inserta tu endpoint y recibe notificaciones sobre los cambios en el estado del pedido.

•

Obtén acceso a información útil sobre actualizaciones de seguimiento que recibirás en tiempo real.

No tienes que usar nuestras
API si no quieres

¿Buscas una solución más simple para optimizar tu proceso de envío? Usa la plataforma ShippyPro en lugar de integrar nuestras API. ¿O por qué no ambas? Nuestra plataforma siempre se actualiza con consejos útiles.

Empieza tu prueba gratuita

La ayuda cuando la necesites

Empieza a integrar rápidamente nuestras API con la documentación API, los artículos del centro de ayuda y con nuestros managers de integración que están listos para ayudarte en cada etapa.