GLS ShipIT 3.4.19
GLS ShipIT - REST services
Loading...
Searching...
No Matches
Webservices Fault Responses Samples

Table of Contents

The following samples showcase possible responses to specific errors or missing parameters in webservice requests.

Create parcel

Miscellaneous

  • Request with no body

    HTTP/1.1 400 Bad Request
    message: The Mandatory parameter ShipmentRequestData is not set
    error: MANDATORY_PARAMETER_NOT_SET

  • Request with empty body

    HTTP/1.1 400 Bad Request
    message: The Mandatory parameter Shipment is not set
    error: MANDATORY_PARAMETER_NOT_SET

  • Incoterm field missing

    HTTP/1.1 400 Bad Request
    message: Invalid field shipment.incoterm. Value XXXXXXXX is not a valid value. Shipment validation failed
    error: INVALID_FIELD_VALUE

  • Consignee does not exist
    HTTP/1.1 400 Bad Request
    message: Invalid field ShipmentRequestData.Shipment.Consignee.Address. Value XXXXXXXX is not a valid value. Consignee Address not found in predefined by manufacturer
    error: INVALID_FIELD_VALUE

Authentication Errors

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Basic <Base64(user:password)>

Shipper Validation

  • Shipper does not exist or is not available to the user

    HTTP/1.1 400 Bad Request
    message: Invalid field Shipment.Shipper.ContactID. Value XXXXXXXX is not a valid value. Shipper does not exist or is not available for the user.
    error: INVALID_FIELD_VALUE

  • NameX/Province/City/Streetname/Streetnumber/Telephone/Mobile/Contact person that's too long

    HTTP/1.1 400 Bad Request
    message: Invalid field Shipment.Shipper.Address.XXXXXXXX. Value XXXXXXXX is not a valid value. Value is too long. Maximum is 40
    error: INVALID_FIELD_VALUE

  • Email that's too long

    HTTP/1.1 400 Bad Request
    message: Invalid field Shipment.Shipper.Address.EMail. Value XXXXXXXX is not a valid value. Value is too long. Maximum is 80
    error: INVALID_FIELD_VALUE

  • Email with invalid format
    HTTP/1.1 400 Bad Request
    message: Invalid field shipper.email.wrong_format. Value XXXXXXXX is not a valid value. Shipment
    error: INVALID_FIELD_VALUE

Product validation

  • Product does not exist

    com.fasterxml.jackson.databind.exc.InvalidFormatException:
    Cannot deserialize value of type `eu.glsgroup.fpcs.datatypes.soap.v1.common.ProductType` from String &quot;XXXXXXXX&quot;:
    value not one of declared Enum instance names: [EXPRESS, PARCEL, FREIGHT]

  • Product is not available
    HTTP/1.1 400 Bad Request
    message: Invalid field ShipmentRequestData.Shipment.Product. Value XXXXXXXX is not a valid value. No matching product available for shipper for the given input data (weight and addresses).
    error: INVALID_FIELD_VALUE

Service validation

  • Services that can't be combined

    HTTP/1.1 400 Bad Request
    message: The services XXXXXXXX, XXXXXXXX cannot be combined with the remaining services of this shipment
    error: INVALID_SERVICE_SELECTION

  • Multiple units with concurring services

    HTTP/1.1 400 Bad Request
    message: The services XXXXXXXX, XXXXXXXX cannot be combined with the remaining services of this shipment
    error: INVALID_SERVICE_SELECTION

  • Service does not exist or is not available
    HTTP/1.1 400 Bad Request
    message: Invalid field Shipment.Service.ServiceName. Value XXXXXXXX is not a valid value. Article does not exist or is not available for shipper
    error: INVALID_FIELD_VALUE

Parcel Validation

  • Reference number that's too long

    HTTP/1.1 400 Bad Request
    message: Invalid field Shipment.ShipmentUnit.ShipmentUnitReference. Value XXXXXXXX is not a valid value. Value is too long. Maximum is 40
    error: INVALID_FIELD_VALUE

  • Weight with negative value

    HTTP/1.1 400 Bad Request
    message: Invalid field shipmentunit.weight.toolow. Value XXXXXXXX is not a valid value. Shipment validation failed
    error: INVALID_FIELD_VALUE

  • Weight value with invalid characters
    com.fasterxml.jackson.databind.JsonMappingException:
    Cannot interpret XXXXXXXX as a valid decimal value.

Printing Options Validation

  • TemplateSet does not exist or left empty

    com.fasterxml.jackson.databind.exc.InvalidFormatException:
    Cannot deserialize value of type `eu.glsgroup.fpcs.datatypes.soap.v1.shipmentprocessing.TemplateSet` from String &quot;XXXXXXXX&quot;:
    value not one of declared Enum instance names: [ZPL_300,ZPL_200, NONE]

  • LabelFormat does not exist or left empty

    com.fasterxml.jackson.databind.exc.InvalidFormatException:
    Cannot deserialize value of type `eu.glsgroup.fpcs.datatypes.soap.v1.shipmentprocessing.LabelFormat` from String &quot;XXXXXXXX&quot;:
    value not one of declared Enum instance names: [PDF, PNG, ZEBRA]

  • Printer does not exist

    HTTP/1.1 400 Bad Request
    message: Invalid field PrintingOptions.DefinePrinter.DocumentPrinter. Value XXXXXXXX is not a valid value. Printer not found in configuration.
    error: INVALID_FIELD_VALUE

  • Label printer does not exist

    HTTP/1.1 400 Bad Request
    message: Invalid field PrintingOptions.DefinePrinter.LabelPrinter. Value XXXXXXXX is not a valid value. Printer not found in configuration.
    error: INVALID_FIELD_VALUE

  • Default printer field with invalid value

    HTTP/1.1 400 Bad Request
    message: Invalid field PrintingOptions.UseDefault. Value XXXXXXXX is not a valid value. Invalid field PrintingOptions.UseDefault. Value XXXXXXXX is not a valid value
    error: INVALID_FIELD_VALUE

  • Printing options fields left empty
    HTTP/1.1 400 Bad Request
    message: The Mandatory parameter ShipmentRequestData.PrintingOptions is not set
    error: INVALID_FIELD_VALUE

Consignee Address

  • Zip code invalid or left empty

    HTTP/1.1 400 Bad Request
    message: Invalid field consignee.zip. Value XXXXXXXX is not a valid value. Shipment validation failed
    error: INVALID_FIELD_VALUE

  • CountryCode left empty

    HTTP/1.1 400 Bad Request
    message: The Mandatory parameter Shipment.Consignee.Address.CountryCode is not set
    error: MANDATORY_PARAMETER_NOT_SET

  • CountryCode field set with invalid or unknown values

    HTTP/1.1 400 Bad Request
    message: Invalid field Shipment.Consignee.Address.CountryCode. Value XXXXXXXX is not a valid value. Mandatory field is not set or invalid
    error: INVALID_FIELD_VALUE

  • NameX/Province/City/Street/Streetnumber/Contact person that's too long

    HTTP/1.1 400 Bad Request
    message: Invalid field Shipment.Consignee.Address.XXXXXXXX. Value XXXXXXXX is not a valid value. Value is too long. Maximum is 40
    error: INVALID_FIELD_VALUE

  • Email that's too long

    HTTP/1.1 400 Bad Request
    message: Invalid field Shipment.Consignee.Address.EMail. Value XXXXXXXX is not a valid value. Value is too long. Maximum is 80
    error: INVALID_FIELD_VALUE

  • Telephone or mobile number that's too long
    HTTP/1.1 400 Bad Request
    message: Mobile or telephone number length exceeds 40
    error: NUMBER_EXCEEDS_LENGTH

IdentPIN

  • Pin that's too short or no Pin

    HTTP/1.1 400 Bad Request
    message: Invalid field ShipmentRequestData.Shipment.Service.IdentPin.PIN. Value XXXXXXXX is not a valid value. Value is too short. Minimum 4

  • Pin that's too long

    HTTP/1.1 400 Bad Request
    message: Invalid field ShipmentRequestData.Shipment.Service.IdentPin.PIN. Value XXXXXXXX is not a valid value. Value is too long. Maximum is 4
    error: INVALID_FIELD_VALUE

  • Pin with invalid characters

    HTTP/1.1 400 Bad Request
    message: Invalid field pin. Value XXXXXXXX is not a valid value. Value contains characters that are not allowed
    error: INVALID_FIELD_VALUE

  • Birthdate field set with past/future values

    HTTP/1.1 400 Bad Request
    message: Invalid field article.identPin.birthdate. Value XXXXXXXX is not a valid value. Shipment validation failed
    error: INVALID_FIELD_VALUE

  • Birthdate field set with an invalid format

    com.fasterxml.jackson.databind.JsonMappingException:
    Cannot interpret XXXXXXXX as a valid date.

  • Birthdate field left empty
    com.fasterxml.jackson.databind.JsonMappingException:
    Unexpected character XXXXXXXX (code 125)): expected a value

IdentService

  • Firstname/Lastname that's too long

    HTTP/1.1 400 Bad Request
    message: Invalid field ShipmentRequestData.Shipment.Service.Ident.XXXXXXXX. Value XXXXXXXX is not a valid value. Value is too long. Maximum is 40
    error: INVALID_FIELD_VALUE

  • Firstname/Lastname left empty

    HTTP/1.1 400 Bad Request
    message: Invalid field Ident.XXXXXXXX. Value is not a valid value. Value is mandatory
    error: INVALID_FIELD_VALUE

  • Invalid country code value
    HTTP/1.1 400 Bad Request
    message: Invalid field Ident.Nationality. Value XXXXXXXX is not a valid value. Mandatory field is not set or invalid
    error: INVALID_FIELD_VALUE

HazardousGoods

  • Weight that's too high/negative/zero

    HTTP/1.1 400 Bad Request
    message: Invalid field shipmentunit.weight.XXXXXXXX. Value XXXXXXXX is not a valid value. Shipment validation failed
    error: INVALID_FIELD_VALUE

  • Weight field left empty

    com.fasterxml.jackson.databind.JsonMappingException:
    Cannot interpret as a valid decimal value.

  • ID field does not exist or is not available
    HTTP/1.1 400 Bad Request
    message: Invalid field ShipmentRequestData.Shipment.ShipmentUnit.Service.HazardousGoods.HazardousGood.GLSHazNo. Value XXXXXXXX is not a valid value.
    Hazardous good does not exist or is not available for the shipper
    error: INVALID_FIELD_VALUE

CashService

  • Reason field left empty

    HTTP/1.1 400 Bad Request
    message: Invalid field Cash.Reason. Value is not a valid value. Value is mandatory
    error: INVALID_FIELD_VALUE

  • Reason field that's too long

    HTTP/1.1 400 Bad Request
    message: Invalid field ShipmentRequestData.Shipment.ShipmentUnit.Service.Cash.Reason. Value XXXXXXXX is not a valid value. Value is too long. Maximum is 160
    error: INVALID_FIELD_VALUE

  • Incorrect currency

    HTTP/1.1 400 Bad Request
    message: Invalid field shipmentunit.article.cod.wrongcurrency. Value XXXXXXXX is not a valid value. Shipment validation failed
    error: INVALID_FIELD_VALUE

  • Amount field with zero or negative value

    HTTP/1.1 400 Bad Request
    message: Invalid field article.attribute.notpositive. Value XXXXXXXX is not a valid value. Shipment validation failed
    error: INVALID_FIELD_VALUE

  • Amount field left empty

    HTTP/1.1 400 Bad Request
    message: Invalid field null. Value null is not a valid value. Value is mandatory
    error: INVALID_FIELD_VALUE

  • Amount value with invalid characters

    com.fasterxml.jackson.databind.JsonMappingException: Cannot interpret XXXXXXXX as a valid decimal value.

  • Amount value that's too high
    HTTP/1.1 400 Bad Request
    message: Invalid field shipmentunit.attribute.cod.toohigh. Value XXXXXXXX is not a valid value. Shipment validation failed
    error: INVALID_FIELD_VALUE

ShopDelivery

  • ShopID field left empty

    HTTP/1.1 400 Bad Request
    message: Invalid field ShipmentRequestData.Shipment.Service.ShopDelivery.ParcelShopID. Value is not a valid value. Value is too short. Minimum 1
    error: INVALID_FIELD_VALUE

  • ShopID field that's too long

    HTTP/1.1 400 Bad Request
    message: Invalid field ShipmentRequestData.Shipment.Service.ShopDelivery.ParcelShopID. Value XXXXXXXX is not a valid value. Value is too long. Maximum is 10
    error: INVALID_FIELD_VALUE

  • Unroutable parcelshop

    HTTP/1.1 400 Bad Request
    message: Invalid field routing. Value XXXXXXXX is not a valid value. Shipment validation failed
    error: INVALID_FIELD_VALUE

  • No consignee contact data provided
    HTTP/1.1 400 Bad Request
    message: Invalid field consignee.shopDelivery. Value XXXXXXXX is not a valid value. Shipment validation failed
    error: INVALID_FIELD_VALUE

ShopReturn

  • NumberOfLabels field with zero or negative value

    HTTP/1.1 400 Bad Request
    message: Invalid field Shipment.Service.ShopReturn.NumberOfLabels. Value XXXXXXXX is not a valid value. Invalid field Shipment.Service.ShopReturn.NumberOfLabels. Value XXXXXXXX is not a valid value
    error: INVALID_FIELD_VALUE

  • Service not available
    HTTP/1.1 400 Bad Request
    message: Invalid field article.notavailable. Value XXXXXXXX is not a valid value. Shipment validation failed
    error: INVALID_FIELD_VALUE

InterCompany

  • NameX/Province/City/Street/Streetnumber/Telephone/Mobile that's too long

    HTTP/1.1 400 Bad Request
    message: Invalid field Shipment.ShipmentService.[Intercompany|Exchange].Address.XXXXXXXX. Value XXXXXXXX is not a valid value. Value is too long. Maximum is 40
    error: INVALID_FIELD_VALUE

  • Email that's too long

    HTTP/1.1 400 Bad Request
    message: Invalid field Shipment.ShipmentService.[Intercompany|Exchange].Address.EMail. Value XXXXXXXX is not a valid value. Value is too long. Maximum is 80
    error: INVALID_FIELD_VALUE

  • NumberOfLabels field with zero or negative value

    HTTP/1.1 400 Bad Request
    message: Invalid field Shipment.Service.Intercompany.NumberOfLabels. Value XXXXXXXX is not a valid value. Invalid field Shipment.Service.ShopReturn.NumberOfLabels. Value XXXXXXXX is not a valid value
    error: INVALID_FIELD_VALUE

  • Zip code field that's left empty

    HTTP/1.1 400 Bad Request
    message: Invalid field Intercompany.Address.ZIPCode. Value null is not a valid value. Value is mandatory
    error: INVALID_FIELD_VALUE

  • CountryCode field that's left empty
    HTTP/1.1 400 Bad Request
    message: Invalid field Intercompany.Address.CountryCode. Value null is not a valid value. Value is mandatory
    error: INVALID_FIELD_VALUE

Exchange

  • Zip code field that's left empty

    HTTP/1.1 400 Bad Request
    message: Invalid field Exchange.Address.ZIPCode. Value null is not a valid value. Value is mandatory
    error: INVALID_FIELD_VALUE

  • CountryCode field that's left empty

    HTTP/1.1 400 Bad Request
    message: Invalid field Exchange.Address.CountryCode. Value null is not a valid value. Value is mandatory
    error: INVALID_FIELD_VALUE

  • NameX/Province/City/Street/Streetnumber/Telephone/Mobile that's too long

    HTTP/1.1 400 Bad Request
    message: Invalid field Shipment.ShipmentService.[Intercompany|Exchange].Address.XXXXXXXX. Value XXXXXXXX is not a valid value. Value is too long. Maximum is 40
    error: INVALID_FIELD_VALUE

  • Email that's too long
    HTTP/1.1 400 Bad Request
    message: Invalid field Shipment.ShipmentService.[Intercompany|Exchange].Address.EMail. Value XXXXXXXX is not a valid value. Value is too long. Maximum is 80
    error: INVALID_FIELD_VALUE

DeliveryAtWork

  • Weight that's too high/low/negative

    HTTP/1.1 400 Bad Request
    message: Invalid field shipmentunit.weight.XXXXXXXX. Value XXXXXXXX is not a valid value. Shipment validation failed
    error: INVALID_FIELD_VALUE

  • Weight field left empty

    com.fasterxml.jackson.databind.JsonMappingException:
    Cannot interpret as a valid decimal value.

  • RecipientName/AlternateRecipientName/Building/Floor/Room/Telephone that's too long
    HTTP/1.1 400 Bad Request
    message: Invalid field ShipmentRequestData.Shipment.Service.DeliveryAtWork.XXXXXXXX. Value XXXXXXXX is not a valid value. Value is too long. Maximum is 40
    error: INVALID_FIELD_VALUE

Deposit

  • PlaceOfDeposit that's too long
    HTTP/1.1 400 Bad Request
    message: Invalid field ShipmentRequestData.Shipment.Service.Deposit.PlaceOfDeposit. Value XXXXXXXX is not a valid value. Value is too long. Maximum is 121
    error: INVALID_FIELD_VALUE

AddOnLiability

  • Amount field with zero or negative value

    HTTP/1.1 400 Bad Request
    message: Invalid field shipmentunit.article.addonliability.notavailable. Value XXXXXXXX is not a valid value. Shipment validation failed
    error: INVALID_FIELD_VALUE

  • Amount field left empty

    com.fasterxml.jackson.databind.JsonMappingException:
    Cannot interpret as a valid decimal value.

  • Currency field set with invalid value or left empty
    HTTP/1.1 400 Bad Request
    message: Invalid field shipmentunit.article.addonliability.wrongcurrency. Value XXXXXXXX is not a valid value. Shipment validation failed
    error: INVALID_FIELD_VALUE

CustomContent

  • Barcode type invalid or empty
    com.fasterxml.jackson.databind.exc.InvalidFormatException:
    Cannot deserialize value of type `eu.glsgroup.fpcs.datatypes.soap.v1.shipmentprocessing.BarcodeType` from String &quot;XXXXXXXX&quot;:
    value not one of declared Enum instance names: [CODE_39, EAN_128]
Generated on Tue Jan 9 2024 14:29:30 for GLS ShipIT by doxygen 1.9.7