Envíos

Crear un envío sin cotizar

Crea un envío directamente sin una cotización previa. El cálculo del precio se realiza internamente con los parámetros de tu solicitud.

Consideraciones

  • Cobertura: te recomendamos cotizar siempre tus envíos para confirmar la cobertura de la paquetería y evitar errores en la creación o en la entrega.
  • Tiempos de espera: si la petición excede el tiempo límite mientras el envío se está creando, no reintentes el POST. Usa el endpoint GET para consultar el estado del envío y obtener la guía generada.
post/api/v1/rate/shipments/

Request

  • Base URL: https://api-pro.skydropx.com
  • URL: https://api-pro.skydropx.com/api/v1/rate/shipments/
  • Auth: HTTP bearer

Request body

OR

Example request

{
  "timeout": 8,
  "sync_label_creation": true,
  "quotation": {
    "printing_format": "thermal",
    "carrier": {
      "name": "Nombre de la paquetería en minúscula",
      "service_name": "Código del servicio"
    },
    "address_from": {
      "address_template_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "country_code": "MX",
      "postal_code": "68000",
      "area_level1": "Oaxaca",
      "area_level2": "Oaxaca de Juárez",
      "area_level3": "Oaxaca centro",
      "name": "John Doe",
      "street1": "Calle Example",
      "company": "Acme INC",
      "phone": "4434434445",
      "email": "homero@simpson.com",
      "reference": "Casa de Homero",
      "tax_id_number": "XAXX010101000"
    },
    "address_to": {
      "address_template_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "country_code": "MX",
      "postal_code": "68000",
      "area_level1": "Oaxaca",
      "area_level2": "Oaxaca de Juárez",
      "area_level3": "Oaxaca centro",
      "name": "John Doe",
      "street1": "Calle Example",
      "company": "Example Company LTDA.",
      "phone": "4434434444",
      "email": "bart@simpson.com",
      "reference": "Casa de Bart",
      "further_information": "Dejar con el vecino",
      "tax_id_number": "123456789"
    },
    "parcels": [
      {
        "weight": 5,
        "height": 5,
        "width": 5,
        "length": 5,
        "package_number": "1",
        "package_protected": true,
        "declared_value": 2500,
        "consignment_note": "53102400",
        "package_type": "4G"
      }
    ]
  }
}

Response

Retorna el envío creado

idstring uuid required
statusstring required
master_tracking_numberstring nullable
label_urlstring nullable
order_detail_urlstring nullable

URL al PDF del detalle de la orden (packing slip). Se completa cuando include_order_detail: true fue enviado en el request y el documento se generó correctamente. null en caso contrario.

error_message_detailstring nullable
packagesobject[] required

Example response

{
  "id": "73783895-147e-40f6-83d8-5f901d71a1a3",
  "status": "success",
  "master_tracking_number": "1234567890",
  "label_url": "https://label.com",
  "order_detail_url": "https://api.example.com/rails/active_storage/blobs/.../order_details.pdf",
  "rate": {
    "id": "38ed719c-6a21-4b15-9ef3-d2bdce374018",
    "rate_type": "standard",
    "provider_name": "medrano santillán s.r.l chad",
    "provider_display_name": "Ups",
    "provider_service_name": "Medrano Santillán S.R.L Chad Bronze",
    "provider_service_code": "MEDRANO_SANTILLAN_S_R_L_CHAD_BRONZE",
    "status": "pending",
    "currency_code": "MXN",
    "amount": "9.99",
    "total": "100",
    "days": 1,
    "own_agreement_amount": "50.00",
    "extra_fees": [],
    "country_code": "MX",
    "packaging_type": "package",
    "weight": "0.0",
    "protection_value_total": "0.0",
    "pickup_package_min": 1,
    "shipment_creation_type": "single",
    "customs_payment_payer": [
      "sender",
      "recipient"
    ]
  },
  "error_message_detail": "Invalid token",
  "packages": []
}

Changes

No recorded changes to this operation across all 1 revision of this API.