Operar · Devoluciones
Gestiona la logística inversa sin aprender otra API.
El Conector vincula la recogida o devolución con el envío original y conserva las diferencias de cada transportista detrás de un contrato común.
/v1/shipments/{shipment_id}/reverse-logistics-policyPregunta antes de ofrecer una devolución
Revisa available, reason_code y conditions. La respuesta combina el estado de la conexión, la homologación del adaptador y las instantáneas conservadas del envío.
curl --request GET \
--url "$API_BASE_URL/v1/shipments/$SHIPMENT_ID/reverse-logistics-policy" \
--header "Authorization: Bearer $SENDINGBAY_API_TOKEN"/v1/shipments/{shipment_id}/reverse-logisticsCrea una operación idempotente
Si omites direcciones y bultos, la recogida usa el destinatario del envío original, el retorno usa su remitente y se reutilizan sus bultos. Puedes reemplazarlos expresamente cuando el caso lo requiera.
curl --request POST \
--url "$API_BASE_URL/v1/shipments/$SHIPMENT_ID/reverse-logistics" \
--header "Authorization: Bearer $SENDINGBAY_API_TOKEN" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: devolucion-order-123-v1" \
--data '{
"article_code": "19H",
"pickup_date": "2026-10-05",
"pickup_window_from": "09:00",
"pickup_window_to": "13:00",
"external_reference": "RETURN-ORDER-123"
}'/v1/shipments/{shipment_id}/reverse-logisticsConsulta el historial minimizado
El listado devuelve referencias, artículo, ventana, etiqueta cuando exista y fecha de creación. No reproduce direcciones, teléfonos ni credenciales. Al completarse también puede recibirse el evento shipment.reverse_logistics_created.
curl --request GET \
--url "$API_BASE_URL/v1/shipments/$SHIPMENT_ID/reverse-logistics" \
--header "Authorization: Bearer $SENDINGBAY_API_TOKEN"