Update Associated Location

put

https://api.intersoftsapient.net/v4/shippingAccounts/rm/{shippingAccountId}/shippingLocations/{shippingLocationId}

Update the details of an existing shipping location associated with a specific Royal Mail shipping account with carrier specific details, such as posting location, OBA access code, and receiving hub code.

Path Params

shippingAccountId

string

required

A unique identifier for the shipping account assigned by the system (ShippingAccountId) or by you (AccountAlias), allowing for efficient reference and management of individual accounts within the system.

shippingLocationId

string

required

A unique identifier for the shipping location assigned by the system or by you (alias), allowing users to reference and manage specific locations effectively.

Body Params

Location Details

Royal Mail Update Shipping Account Location

PostingLocationCode

string

required

length between 10 and 10

A unique number assigned to this location by Royal Mail. This code is essential for identifying the particular location from which shipments are dispatched. It facilitates the processing and tracking of mail and packages by providing a clear reference to the origin of the shipment within the Royal Mail network.

ObaAccessCode

string | null

The OBA Access Code (Online Business Account Access Code) is a password associated with the Royal Mail shipping account that grants access to the Online Business Account (OBA) services. This code is crucial for ensuring that the account is secure and allows for the management of shipping tasks online.

Note: A Royal Mail shipping account cannot be activated or used for shipping unless the OBA Access Code has been provided.

ReceivingHubCode

string

required

length between 6 and 6

A code that refers to the Receiving Hub or Regional Distribution Center (RDC) used for this shipping location. This code must correspond to an existing Receiving Hub recognised by Royal Mail.

Note: If the Receiving Hub code is not provided during the account creation process, Royal Mail will automatically match it to the Receiving Hub that corresponds to the postcode of the location's address. For more information, refer to the Royal Mail Receiving Hubs for a list of possible locations.

Responses

200

Updates the shipping location

401

Unauthorized

403

Forbidden

404

The shipping location was not found.

500

Internal Server Error

Language

Credentials

OAuth2

Loading…

Response

Choose an example:

application/json

400Invalid request response.