Tarifas de envío API

La API de tarifas de envío calcula las tarifas de envío para los pedidos basándose en la localización del receptor y los contenidos del pedido.

El ID de la tarifa de envíos devueltos puede utilizarse para especificar el método de envío al crear un pedido.

Ver API de país para más información sobre los Códigos de países.

Ver API de catálogo de Printful para más información sobre los ID de Variantes.

Calculate shipping rates

POST https://api.printful.com/shipping/rates

Returns available shipping options and rates for the given list of products.

Parámetros de entrada
Request body ShippingRequest Order information
recipient AddressInfo Recipient location information
address1 string Address line 1
city string City
country_code string Country code
state_code string State code (optional, required for United States, Australia and Canada)
zip string ZIP or postal code (optional, required for some countries to calculate expedited shipping rates)
phone string Phone number (optional)
items ItemInfo [ ] Array of order items
variant_id string Catalog Variant ID of the item ordered. See Product Catalog API

* Required if no other IDs given
external_variant_id string External Variant ID of the item ordered. See Ecommerce Platform Sync API.

* Required if no other IDs given
warehouse_product_variant_id string Warehouse product variant ID of the item ordered. See Warehouse Products API.

* Required if no other IDs given
quantity integer Number of items ordered
value string Item retail value - optional but can help to properly calculate insurance costs for large orders
currency string 3 letter currency code (optional), required if the rates need to be converted to another currency instead of store default currency
locale string Locale in which shipping rate names will be returned. Available options - 'en_US' (default), 'es_ES'
Formato de respuesta:
code integer Código del estado de respuesta 200
result ShippingInfo [ ]
id string Shipping method ID
name string Shipping method name
rate string Shipping rate
currency string Currency code in which the rate is returned
minDeliveryDays int Estimated minimum delivery days. Warning this value may not be present in response.
maxDeliveryDays int Estimated maximum delivery days. Warning this value may not be present in response.
Clave API
Request body
Ejecutar
Calcula las tarifas de transporte para los pedidos de EEUU que contengan un póster y cinco camisetas.
Solicitar cuerpo: 
{
    "recipient": {
        "address1": "19749 Dearborn St",
        "city": "Chatsworth",
        "country_code": "US",
        "state_code": "CA",
        "zip": 91311
    },
    "items": [
        {
            "quantity": 1,
            "variant_id": 2
        },
        {
            "quantity": 5,
            "variant_id": 202
        }
    ]
}
Datos de respuesta: 
{
    "code": 200,
    "result": [{
            "id": "STANDARD",
            "name": "Flat Rate (3-5 business days)",
            "rate": "18.45",
            "currency": "USD"
     }]
}
Calcula las tarifas de transporte a EEUU para pedidos que contengan artículos con tu id de variante externo
Solicitar cuerpo: 
{
    "recipient": {
        "address1": "19749 Dearborn St",
        "city": "Chatsworth",
        "country_code": "US",
        "state_code": "CA",
        "zip": 91311
    },
    "items": [
        {
            "quantity": 1,
            "external_variant_id": 2
        },
        {
            "quantity": 5,
            "variant_id": 202
        }
    ]
}
Datos de respuesta: 
{
    "code": 200,
    "result": [{
        "id": "STANDARD",
        "name": "Flat Rate (3-5 business days)",
        "rate": "18.45",
        "currency": "USD"
    }]
}
Calcula las tarifas de transporte a EEUU para pedidos que contengan artículos con id de variante de almacén
Solicitar cuerpo: 
{
    "recipient": {
        "address1": "19749 Dearborn St",
        "city": "Chatsworth",
        "country_code": "US",
        "state_code": "CA",
        "zip": 91311
    },
    "items": [
        {
            "quantity": 1,
            "warehouse_product_variant_id": 2
        },
        {
            "quantity": 5,
            "variant_id": 202
        }
    ]
}
Datos de respuesta: 
{
    "code": 200,
    "result": [{
        "id": "STANDARD",
        "name": "Flat Rate (3-5 business days)",
        "rate": "18.45",
        "currency": "USD"
    }]
}

¿Listo para probar Printful?

Empieza