Pickup API

{
  "status": "ACCEPTED"
}

{
  "error": {
    "message": "Order has already been picked up"
  },
  "status": "FAILED"
}

{
  "error": {
    "message": "Existing pickup date is already invalid. Pickup can no longer be cancelled or modified."
  },
  "status": "FAILED"
}

{
  "error": {
    "message": "Existing pickup date is already invalid. Pickup can no longer be cancelled or modified."
  },
  "status": "FAILED"
}

{
  "error": {
    "message": "Order is invalid"
  },
  "status": "FAILED"
}

{
  "error": {
    "message": "This user is not authorized to cancel or modify this booking"
  },
  "status": "FAILED"
}

{
  "error": {
    "message": "Could not find existing pickup order"
  },
  "status": "FAILED"
}

{
  "error": {
    "message": "Too many attempts"
  },
  "status": "FAILED"
}

{
  "error": {
    "message": "An unexpected error occurred"
  },
  "status": "FAILED"
}

{
  "errors": null,
  "pickupConfirmation": {
    "earliestPickupDate": 1720159200000,
    "isoFormattedEarliestPickupDateTime": "2024-05-27T08:00:00.000+00:00",
    "isoFormattedLatestPickupDateTime": "2024-05-27T16:00:00.000+00:00",
    "latestPickupDate": 1720188000000,
    "packageNumber": "123456789012345678",
    "status": "OK",
    "url": "https://www.mybring.com/order-pickup/receipt/xxxxxxxxx"
  }
}

<pickupOrderResponse>
    <pickupConfirmation>
        <status>OK</status>
        <earliestPickupDate>2024-05-27T08:00:00+00:00</earliestPickupDate>
        <latestPickupDate>2024-05-27T16:00:00+00:00</latestPickupDate>
        <url>https://www.mybring.com/order-pickup/receipt/xxxxxxxxx</url>
        <packageNumber>123456789012345678</packageNumber>
    </pickupConfirmation>
</pickupOrderResponse>

{
  "errors": [
    {
      "code": "BOOK-INPUT-022",
      "messages": [
        {
          "lang": "en",
          "message": "Illegal product for country"
        }
      ],
      "uniqueId": "144cb4f6-c21b-4716-841f-d0f29dd707fe"
    }
  ]
}

{
  "errors": [
    {
      "code": "BOOK-INPUT-028",
      "messages": [
        {
          "lang": "en",
          "message": "Invalid country code"
        }
      ],
      "uniqueId": "8f1e9054-4049-4bea-b7bd-1939bd61a796"
    }
  ]
}

{
  "errors": [
    {
      "code": "PICKUP-INPUT-012",
      "messages": [
        {
          "lang": "en",
          "message": "Selected pickup point should be in recipient country"
        }
      ],
      "uniqueId": "db0f24e5-336e-46fd-a53d-9e9cc8bf28de"
    }
  ]
}

{
  "errors": [
    {
      "code": "BOOK-INPUT-020",
      "messages": [
        {
          "lang": "en",
          "message": "Invalid product ID"
        }
      ],
      "uniqueId": "f4cd1391-cd27-4c0f-b1ad-03b2f887595b"
    }
  ]
}

{
  "errors": [
    {
      "code": "PICKUP-INPUT-007",
      "messages": [
        {
          "lang": "en",
          "message": "Pickup date must be in the future"
        }
      ],
      "uniqueId": "5375ea4b-6bbf-4388-964a-6c8ed35acbd1"
    }
  ]
}

{
  "errors": [
    {
      "code": "PICKUP-INPUT-001",
      "messages": [
        {
          "lang": "en",
          "message": "Error with input in pickupOrder"
        }
      ],
      "uniqueId": "e3f572ef-bbeb-4d56-9209-8f276a9f9c6e"
    }
  ]
}

{
  "errors": [
    {
      "code": "PICKUP-INPUT-003",
      "messages": [
        {
          "lang": "en",
          "message": "Cargo customer must provide cargoInformation element. Parcel customer must provide parcelsInformation element"
        }
      ],
      "uniqueId": "e3706cf1-e7cc-482a-81a0-971a3c3201ec"
    }
  ]
}

{
  "errors": [
    {
      "code": "PICKUP-INPUT-015",
      "messages": [
        {
          "lang": "en",
          "message": "Chargeable weight must be below groupage max weight limit"
        }
      ],
      "uniqueId": "b755731c-008e-4c89-8395-4023d00e3e84"
    }
  ]
}

{
  "errors": [
    {
      "code": "PICKUP-INPUT-006",
      "messages": [
        {
          "lang": "en",
          "message": "You must specify pickupDate element yyyy-MM-dd"
        }
      ],
      "uniqueId": "a8f0f52b-79db-4314-aba0-1dbed0d4c80d"
    }
  ]
}

{
  "errors": [
    {
      "code": "PICKUP-INPUT-016",
      "messages": [
        {
          "lang": "en",
          "message": "Must either have weightInGrams in pickupDetails, or on package or pallets level. Can not have both"
        }
      ],
      "uniqueId": "a5230d31-c17f-4f1c-8bd7-fa02511ef302"
    }
  ]
}

{
  "errors": [
    {
      "code": "PICKUP-INPUT-002",
      "messages": [
        {
          "lang": "en",
          "message": "Postal code must be given and be valid"
        }
      ],
      "uniqueId": "63ed8980-bdc1-4d62-8fa1-460c56bc07cf"
    }
  ]
}

{
  "errors": [
    {
      "code": "PICKUP-INPUT-005",
      "messages": [
        {
          "lang": "en",
          "message": "You must specify pickupIsReadyAtTime element HH:mm:ss"
        }
      ],
      "uniqueId": "458e86a3-976b-4d65-86d5-42e25a334e30"
    }
  ]
}

{
  "errors": [
    {
      "code": "PICKUP-INPUT-008",
      "messages": [
        {
          "lang": "en",
          "message": "weightInGrams is required, and must be an integer larger than zero"
        }
      ],
      "uniqueId": "520c4e85-43fc-4f60-b3f3-b19fdd29392a"
    }
  ]
}

{
  "errors": [
    {
      "code": "PICKUP-INPUT-010",
      "messages": [
        {
          "lang": "en",
          "message": "Country code is required"
        }
      ],
      "uniqueId": "c2a869e1-3636-43ad-8110-36d355ab939b"
    }
  ]
}

{
  "errors": [
    {
      "code": "PICKUP-INPUT-009",
      "messages": [
        {
          "lang": "en",
          "message": "Must be an integer larger than zero"
        }
      ],
      "uniqueId": "7b096004-c2b2-41a7-b3b4-40d10384bf0f"
    }
  ]
}

{
  "errors": [
    {
      "code": "PICKUP-INPUT-004",
      "messages": [
        {
          "lang": "en",
          "message": "This customer number cannot be used to order Pickup"
        }
      ],
      "uniqueId": "5fbc922b-0b0e-45a7-8d28-3696f307b513"
    }
  ]
}

{
  "errors": [
    {
      "code": "PICKUP-INPUT-013",
      "messages": [
        {
          "lang": "en",
          "message": "Combination pickupIsReadyAtTime and pickupDate must be in the future"
        }
      ],
      "uniqueId": "a9eb9471-0fe8-44ec-bc59-b3b663b2ec20"
    }
  ]
}

{
  "errors": [
    {
      "code": "PICKUP-INTERNAL-001",
      "messages": [
        {
          "lang": "en",
          "message": "An unexpected error occurred"
        }
      ],
      "uniqueId": "615de8d0-0dd2-420d-8f98-2287bb30c4eb"
    }
  ]
}

{
  "errors": [
    {
      "code": "PICKUP-INPUT-011",
      "messages": [
        {
          "lang": "en",
          "message": "Both Pickup Point ID and Country Code is Required"
        }
      ],
      "uniqueId": "1318a8c4-db33-4208-a2ab-9fc7c789a9eb"
    }
  ]
}

{
  "errors": [
    {
      "code": "BOOK-AUTHORIZATION-001",
      "messages": [
        {
          "lang": "en",
          "message": "Your user is not authorized to perform this action"
        }
      ],
      "uniqueId": "01101bc3-de60-4e20-bf86-e513ca9f45d6"
    }
  ]
}

<?xml version="1.0" encoding="UTF-8"?>
<!-- Example cannot be generated; root element name is undefined -->

<?xml version="1.0" encoding="UTF-8"?>
<!-- Example cannot be generated; root element name is undefined -->

<?xml version="1.0" encoding="UTF-8"?>
<!-- Example cannot be generated; root element name is undefined -->

<?xml version="1.0" encoding="UTF-8"?>
<!-- Example cannot be generated; root element name is undefined -->

<?xml version="1.0" encoding="UTF-8"?>
<!-- Example cannot be generated; root element name is undefined -->

<?xml version="1.0" encoding="UTF-8"?>
<!-- Example cannot be generated; root element name is undefined -->

<?xml version="1.0" encoding="UTF-8"?>
<!-- Example cannot be generated; root element name is undefined -->

<?xml version="1.0" encoding="UTF-8"?>
<!-- Example cannot be generated; root element name is undefined -->

<?xml version="1.0" encoding="UTF-8"?>
<!-- Example cannot be generated; root element name is undefined -->

<?xml version="1.0" encoding="UTF-8"?>
<!-- Example cannot be generated; root element name is undefined -->

<?xml version="1.0" encoding="UTF-8"?>
<!-- Example cannot be generated; root element name is undefined -->

<?xml version="1.0" encoding="UTF-8"?>
<!-- Example cannot be generated; root element name is undefined -->

<?xml version="1.0" encoding="UTF-8"?>
<!-- Example cannot be generated; root element name is undefined -->

<?xml version="1.0" encoding="UTF-8"?>
<!-- Example cannot be generated; root element name is undefined -->

<?xml version="1.0" encoding="UTF-8"?>
<!-- Example cannot be generated; root element name is undefined -->

<?xml version="1.0" encoding="UTF-8"?>
<!-- Example cannot be generated; root element name is undefined -->

<?xml version="1.0" encoding="UTF-8"?>
<!-- Example cannot be generated; root element name is undefined -->

<?xml version="1.0" encoding="UTF-8"?>
<!-- Example cannot be generated; root element name is undefined -->

<?xml version="1.0" encoding="UTF-8"?>
<!-- Example cannot be generated; root element name is undefined -->

<?xml version="1.0" encoding="UTF-8"?>
<!-- Example cannot be generated; root element name is undefined -->

{
  "status": "ACCEPTED"
}

{
  "error": {
    "message": "Order has already been picked up"
  },
  "status": "FAILED"
}

{
  "error": {
    "message": "Existing pickup date is already invalid. Pickup can no longer be cancelled or modified."
  },
  "status": "FAILED"
}

{
  "error": {
    "message": "Pickup date is not available"
  },
  "status": "FAILED"
}

{
  "error": {
    "message": "Existing pickup date is already invalid. Pickup can no longer be cancelled or modified."
  },
  "status": "FAILED"
}

{
  "error": {
    "message": "Provided pickup date is in the past"
  },
  "status": "FAILED"
}

{
  "error": {
    "message": "Provided pickup date is today. Please provide a future date."
  },
  "status": "FAILED"
}

{
  "error": {
    "message": "Malformed payload at line: 1, column: 5"
  },
  "status": "FAILED"
}

{
  "error": {
    "message": "Mismatched type at line: 1, column: 12"
  },
  "status": "FAILED"
}

{
  "error": {
    "message": "Order is invalid"
  },
  "status": "FAILED"
}

{
  "error": {
    "message": "This user is not authorized to cancel or modify this booking"
  },
  "status": "FAILED"
}

{
  "error": {
    "message": "Could not find existing pickup order"
  },
  "status": "FAILED"
}

{
  "error": {
    "message": "Too many attempts"
  },
  "status": "FAILED"
}

{
  "error": {
    "message": "An unexpected error occurred"
  },
  "status": "FAILED"
}

{
  "pickupOptions": [
    {
      "date": "2026-05-15",
      "from": "08:00:00",
      "to": "16:00:00"
    },
    {
      "date": "2026-05-18",
      "from": "08:00:00",
      "to": "16:00:00"
    },
    {
      "date": "2026-05-19",
      "from": "08:00:00",
      "to": "16:00:00"
    },
    {
      "date": "2026-05-20",
      "from": "08:00:00",
      "to": "16:00:00"
    }
  ],
  "price": {
    "amountWithVAT": 535,
    "amountWithoutVAT": 428,
    "vat": 107
  }
}

{
  "validationErrors": [
    {
      "code": "INVALID_POSTAL_CODE",
      "field": "postalCode",
      "message": "Postal code is invalid"
    },
    {
      "code": "COUNTRY_NOT_SUPPORTED",
      "field": "countryCode",
      "message": "Country is not supported for this pickup type"
    }
  ]
}