Skip to main content
A delivery location is an address registered on a relation, so it does not have to be re-entered on every document addressed to it. It is an object of the relation: permissions are those of the relation resource, and relation_id is set at creation — an address never moves to another relation.

Address and identifier

address is the same object as a relation’s address, with the same rules: country_code required, street_number only with street (422 invalid_address otherwise). On PATCH it is merged like on a relation, and the rules are checked on the result. identifier and identifier_scheme designate the location on the Peppol network (a GLN and the scheme code that says how to read it, 0088 for a GLN). They go together: a half-filled pair is refused (422 invalid_identifier), including when a PATCH would remove one half.

On documents

A document accepts a delivery_location_id, at creation as on update, provided the address belongs to the same relation as the document (422 invalid_delivery_location). Changing a document’s relation_id detaches its delivery location; delivery_location_id: null detaches it too.

Deleting

Deletion is refused (409 delivery_location_in_use) as long as a document is linked to the location. Deleting the relation deletes its delivery locations with it.