Party API - Apigee (1.2.0)
Download OpenAPI specification:Download
Party API documentation
Authentication & Authorization
You will need to be identified before calling any endpoints.
In order to be recognized and authorized to access our Party API, we put in place 2 mechanisms:
- Authentication mechanism is done with a client id dedicated to you.
Remember that the client id provided should be shared with care.
The client id must be inserted in the header of the request in the appropriate field - Authorization mechanism is done by a well-known authorization flow for REST Web API: Basic auth flow.
Create retail customer.
This endpoint allows to create or update a retail customer.
Authorizations:
Request Body schema: application/json
externalRef required | string (externalRef) <= 255 characters External reference identifier |
membership | string (membership) <= 255 characters Membership program of the party |
title | string (title) <= 255 characters The title of the contact (e.g., Mr., Mrs., Ms.) |
firstName | string (firstName) <= 255 characters The first name of the contact |
lastName | string (lastName) <= 255 characters The last name of the contact |
secondLastName | string (secondLastName) <= 255 characters The second last name of the contact |
nationalIdentificationNumber | string (nationalIdentificationNumber) <= 255 characters The national identification number of the contact |
string (email) <= 255 characters The email address of the contact | |
phoneNumber | string (phoneNumber) <= 255 characters The phone number of the contact |
mobilePhoneNumber | string (mobilePhoneNumber) <= 255 characters Mobile phone number of the contact |
birthDate | string <date> (birthDate) The birth date of the contact |
addressLine1 | string (addressLine1) <= 255 characters The first line of the address |
addressLine2 | string (addressLine2) <= 255 characters The second line of the address |
addressLine3 | string (addressLine3) <= 255 characters The third line of the address |
postalCode | string (postalCode) <= 255 characters The postal code of the address |
city | string (city) <= 255 characters The city of the address |
subdivision | string (subdivision) <= 255 characters The subdivision (e.g., state, province) of the address |
countryCode required | string (countryCode) <= 255 characters The country code of the address |
object The contact's communication preferences | |
object (gdpr) GDPR consent details. |
Responses
Request samples
- Payload
{- "externalRef": "12345678",
- "membership": "Michelin",
- "title": "M",
- "firstName": "John",
- "lastName": "DOE",
- "secondLastName": null,
- "nationalIdentificationNumber": "12345678E",
- "email": "mail@email.com",
- "phoneNumber": "00 001 1111111",
- "mobilePhoneNumber": null,
- "birthDate": "1990-10-10",
- "addressLine1": "Neumarkter Str.",
- "addressLine2": null,
- "addressLine3": null,
- "postalCode": "44666",
- "city": "City",
- "subdivision": null,
- "countryCode": "DE",
- "communicationChannel": {
- "sms": {
- "authorized": true,
- "marketingConsent": true,
- "consentDate": "2024-09-10"
}, - "email": {
- "authorized": true,
- "marketingConsent": true,
- "consentDate": null
}, - "postal": {
- "authorized": true,
- "marketingConsent": true,
- "consentDate": null
}
}, - "gdpr": {
- "signed": true,
- "signedDate": "2024-12-27"
}
}
Response samples
- 200
- 400
- 401
- 500
{- "code": "10001111"
}
List of customers for which my company is contractor
List of customers for which my company is contractor. The response is sorted by name.
Authorizations:
query Parameters
name required | string (CustomerNameQueryParam) [ 1 .. 100 ] characters Example: name=Euromaster The value contained in the customer's name |
type | string (TypeEnum) Enum: "B2B" "B2C" Example: type=B2B Customer's type |
limit | integer <int32> (Limit100QueryParam) [ 1 .. 100 ] Default: 100 Example: limit=2 The limit size |
Responses
Response samples
- 200
- 400
- 401
- 404
- 500
[- {
- "code": 100001,
- "name": "EUROMASTER SERVICE ET MANAGEMENT"
}, - {
- "code": 100006,
- "name": "TRANSPORT NICOLAS"
}
]
Retrieves the list of sites associated with the customer identified by partyCode.
Access is limited to customers related to the user's party, and appropriate permissions must be verified.
Authorizations:
path Parameters
partyCode required | integer <int32> (PartyCodeQueryParam) Example: 1000001 Targeted party code |
query Parameters
pageNumber | integer <int32> (PageNumberQueryParam) [ 1 .. 1000 ] Default: 1 Example: pageNumber=2 The page number |
pageSize | integer <int32> (PageSizeQueryParam) [ 1 .. 1000 ] Default: 1000 Example: pageSize=2 The page size |
name | string (CustomerNameQueryParam) [ 1 .. 100 ] characters Example: name=Euromaster The value contained in the customer's name |
withInactive | boolean (WithInactiveQueryParam) Default: false Example: withInactive=true If filled then return active and inactive parties (default false) |
Responses
Response samples
- 200
- 400
- 401
- 403
- 404
- 500
{- "pagination": {
- "next": "/party-erm/v1/customers/1000000/sites?page=2&size=50",
- "previous": "/party-erm/v1/customers/1000000/sites?page=1&size=50",
- "pageTotal": "3",
- "totalElements": "125"
}, - "sites": [
- {
- "code": 100023,
- "name": "Euromaster Kepler",
- "legalIdentifier": {
- "siret": "36252187900034"
}, - "partyCode": 1000032,
- "functionalRef": "B1234",
- "active": true,
- "addressLine1": "Industrichone",
- "addressLine2": null,
- "addressLine3": null,
- "postalCode": "42697",
- "city": "Solingen",
- "subdivision": "Castelló",
- "countryCode": "ES",
- "lastModifiedDate": "2024-12-27T12:23:23",
- "lastModifiedBy": "user@email.com"
}, - {
- "code": 100024,
- "name": "Euromaster Neumarkt",
- "legalIdentifier": {
- "siret": "36252187900034"
}, - "partyCode": 1000033,
- "functionalRef": "B1234",
- "active": true,
- "addressLine1": "Industrichone",
- "addressLine2": null,
- "addressLine3": null,
- "postalCode": "92318",
- "city": "Neumarkt",
- "subdivision": "Castelló",
- "countryCode": "ES",
- "lastModifiedDate": "2024-12-27T12:23:23",
- "lastModifiedBy": "user@email.com"
}
]
}
Get parties data
Get parties data filtered by parameters
Authorizations:
query Parameters
pageNumber | integer <int32> (PageNumberQueryParam) [ 1 .. 1000 ] Default: 1 Example: pageNumber=2 The page number |
pageSize | integer <int32> (PageSizeQueryParam) [ 1 .. 1000 ] Default: 1000 Example: pageSize=2 The page size |
lastModifiedDateFrom | string <date-time> (LastModifiedDateFromQueryParam) Example: lastModifiedDateFrom=2024-05-02T10:00:00 Date from for last update date of data |
lastModifiedDateTo | string <date-time> (LastModifiedDateToQueryParam) Example: lastModifiedDateTo=2024-05-02T10:00:00 Date to for last update date of data |
externalRef | string (externalRef) <= 255 characters Example: externalRef=12345678 external ref of the party |
source | string (source) <= 255 characters Example: source=GENES source of the party |
Responses
Response samples
- 200
- 400
- 401
- 404
- 500
{- "pagination": {
- "next": "/party-erm/v1/parties/extended?page=3&size=50",
- "previous": "/party-erm/v1/parties/extended?page=1&size=50",
- "pageTotal": "3",
- "totalElements": "125"
}, - "parties": [
- {
- "code": "100001",
- "type": "B2C",
- "active": true,
- "membership": "Michelin",
- "legalIdentifier": {
- "siren": 123456789,
- "NIF": "ES12345678",
- "vatNumber": "ES12345678"
}, - "sites": [
- {
- "code": "100011",
- "name": "John DOE",
- "legalIdentifier": {
- "siret": 36252187900034
}, - "addressLine1": "Neumarkter Str.",
- "addressLine2": null,
- "addressLine3": null,
- "postalCode": "44666",
- "city": "City",
- "subdivision": null,
- "countryCode": "DE",
- "contact": [
- {
- "code": "100111",
- "title": "M",
- "firstName": "John",
- "lastName": "DOE",
- "secondLastName": null,
- "nationalIdentificationNumber": "12345678E",
- "email": "mail@email.com",
- "phoneNumber": "00 001 1111111",
- "mobilePhoneNumber": null,
- "birthDate": "1990-10-10",
- "communicationChannel": {
- "sms": {
- "authorized": true,
- "marketingConsent": true,
- "consentDate": "2024-09-10"
}, - "email": {
- "authorized": true,
- "marketingConsent": true,
- "consentDate": "2024-09-11"
}, - "postal": {
- "authorized": true,
- "marketingConsent": true,
- "consentDate": "2024-09-12"
}
}, - "gdpr": {
- "signed": true,
- "signedDate": "2024-12-27"
}
}
]
}
], - "references": [
- {
- "source": "GENES",
- "externalRef": "12345678",
- "countryCode": "ES",
- "lastModifiedDate": "2024-12-27T12:23:23"
}
]
}
]
}
Get parties data
Get parties data by party code
Authorizations:
path Parameters
partyCode required | integer <int32> (PartyCodeQueryParam) Example: 1000001 Targeted party code |
Responses
Response samples
- 200
- 401
- 404
- 500
{- "code": "100011",
- "type": "B2C",
- "active": true,
- "membership": "Michelin",
- "legalIdentifier": {
- "siren": 123456789,
- "NIF": "ES12345678",
- "vatNumber": "ES12345678"
}, - "sites": [
- {
- "code": "100111",
- "name": "John Doe",
- "legalIdentifier": {
- "siret": 36252187900034
}, - "addressLine1": "Address Line 1",
- "addressLine2": "Address Line 2",
- "addressLine3": "Address Line 3",
- "postalCode": "42697",
- "city": "City",
- "subdivision": "Subdivision",
- "countryCode": "FR",
- "contact": [
- {
- "code": "100111",
- "title": "M",
- "firstName": "John",
- "lastName": "Doe",
- "secondLastName": "Smith",
- "nationalIdentificationNumber": "12345678E",
- "email": "mail@email.com",
- "phoneNumber": "00 001 1111111",
- "mobilePhoneNumber": "00 001 1111111",
- "birthDate": "1990-10-10",
- "communicationChannel": {
- "sms": {
- "authorized": true,
- "marketingConsent": true,
- "consentDate": "2024-09-10"
}, - "email": {
- "authorized": true,
- "marketingConsent": true,
- "consentDate": "2024-09-11"
}, - "postal": {
- "authorized": true,
- "marketingConsent": true,
- "consentDate": "2024-09-12"
}
}, - "gdpr": {
- "signed": true,
- "signedDate": "2024-12-27"
}
}
]
}
], - "references": [
- {
- "source": "GENES",
- "externalRef": "12345678",
- "countryCode": "ES",
- "lastModifiedDate": "2024-12-27T12:23:23"
}
]
}
Create party data
Create party external
Authorizations:
Request Body schema: application/json
externalRef required | string (externalRef) <= 255 characters External reference identifier |
functionalRef | string (functionalRef) <= 255 characters Functional reference identifier |
type required | string (TypeEnum) Enum: "B2B" "B2C" The type of the party |
name | string (name) <= 255 characters The name |
active | boolean (active) Active flag |
object (PartyLegalIdentifierDTO) Legal identifier information |
Responses
Request samples
- Payload
Create a party with the given informations
{- "externalRef": "YEIZR",
- "functionalRef": "B1234",
- "type": "B2B",
- "name": "TRANSPORT NICOLAS",
- "active": true,
- "legalIdentifier": {
- "siren": "123456789",
- "NIF": "Y1234567A",
- "vatNumber": "FR123456789"
}
}
Response samples
- 200
- 400
- 401
- 500
{- "code": 10001111
}
Quick search parties data
Quick search parties data (name and code) filtered by parameters
Authorizations:
query Parameters
value required | string (ValueQueryParam) [ 1 .. 255 ] characters Example: value=Transp The value contained in the party's name |
limit | integer <int32> (LimitQueryParam) [ 1 .. 1000 ] Default: 100 Example: limit=2 The limit size |
Responses
Response samples
- 200
- 400
- 401
- 500
[- {
- "code": 100001,
- "name": "TRANSPORT NICOLAS"
}, - {
- "code": 100006,
- "name": "TRANSPORT XXX"
}
]
Create a party.
This endpoint allows to create a party.
Authorizations:
Request Body schema: application/json
functionalRef | string (functionalRef) <= 255 characters Functional reference identifier |
type required | string (TypeEnum) Enum: "B2B" "B2C" The type of the party |
name | string (name) <= 255 characters The name |
Responses
Request samples
- Payload
{- "functionalRef": "B1234",
- "type": "B2B",
- "name": "TRANSPORT NICOLAS"
}
Response samples
- 200
- 400
- 401
- 500
{- "code": 100001,
- "functionalRef": "B1234",
- "type": "B2B",
- "active": true,
- "name": "TRANSPORT NICOLAS",
- "lastModifiedDate": "2024-12-27:12:23:23"
}
Get parties data
Get parties data filtered by parameters
Authorizations:
query Parameters
pageNumber | integer <int32> (PageNumberQueryParam) [ 1 .. 1000 ] Default: 1 Example: pageNumber=2 The page number |
pageSize | integer <int32> (PageSizeQueryParam) [ 1 .. 1000 ] Default: 1000 Example: pageSize=2 The page size |
lastModifiedDateFrom | string <date-time> (LastModifiedDateFromQueryParam) Example: lastModifiedDateFrom=2024-05-02T10:00:00 Date from for last update date of data |
lastModifiedDateTo | string <date-time> (LastModifiedDateToQueryParam) Example: lastModifiedDateTo=2024-05-02T10:00:00 Date to for last update date of data |
functionalRef | string (functionalRef) <= 255 characters Example: functionalRef=B1234 Functional reference |
type | string (TypeEnum) Enum: "B2B" "B2C" Example: type=B2B Type of parties |
withInactive | boolean (WithInactiveQueryParam) Default: false Example: withInactive=true If filled then return active and inactive parties (default false) |
withExternalRef | boolean (WithExternalRefQueryParam) Default: false Example: withExternalRef=true If filled then return external references for each party (default false) |
codes | Array of integers <int64> (PartyCodeListQueryParameter) [ 1 .. 100 ] items [ items <int64 > ] Example: codes=123,234 List of party code |
Responses
Response samples
- 200
- 400
- 401
- 404
- 500
{- "pagination": {
- "next": "/party-erm/v1/parties?page=3&size=50",
- "previous": "/party-erm/v1/parties?page=1&size=50",
- "pageTotal": "3",
- "totalElements": "125"
}, - "parties": [
- {
- "code": "100001",
- "functionalRef": "B1234",
- "type": "B2C",
- "active": true,
- "name": "Michelin",
- "lastModifiedDate": "2024-12-27:12:23:23",
- "references": [
- {
- "source": "GENES",
- "externalRef": "12345678",
- "countryCode": "ES",
- "lastModifiedDate": "2024-12-27T12:23:23"
}
]
}
]
}
Get a party
Retrieve a party by his code
Authorizations:
path Parameters
partyCode required | integer <int32> (PartyCodeQueryParam) Example: 1000001 Targeted party code |
Responses
Response samples
- 200
- 401
- 404
- 500
{- "code": 1020202,
- "name": "SARL BTP PRADELS",
- "functionalRef": "B1234",
- "type": "B2B",
- "active": true,
- "membership": "Association Charade",
- "legalIdentifier": {
- "siren": "824393151",
- "nif": "X9956748M",
- "VATNumber": "FR50824393151"
}, - "lastModifiedDate": "2024-12-27T12:23:23",
- "lastModifiedBy": "user1"
}
Update a party
Update a party by his code
Authorizations:
path Parameters
partyCode required | integer <int32> (PartyCodeQueryParam) Example: 1000001 Targeted party code |
Request Body schema: application/json
functionalRef | string (functionalRef) <= 255 characters Functional reference identifier |
type required | string (TypeEnum) Enum: "B2B" "B2C" The type of the party |
name | string (name) <= 255 characters The name |
Responses
Request samples
- Payload
{- "functionalRef": "B1234",
- "type": "B2B",
- "name": "TRANSPORT NICOLAS"
}
Response samples
- 200
- 401
- 404
- 500
{- "code": 100001,
- "functionalRef": "B1234",
- "type": "B2B",
- "active": true,
- "name": "TRANSPORT NICOLAS",
- "lastModifiedDate": "2024-12-27:12:23:23"
}
Delete a party
Update a party to set his active attribute to false
Authorizations:
path Parameters
partyCode required | integer <int32> (PartyCodeQueryParam) Example: 1000001 Targeted party code |
Responses
Response samples
- 404
- 500
{- "errors": [
- {
- "error": "The party code XXABCXX cannot be found",
- "property": "partyCode"
}
]
}
Get sites for a party
Retrieve sites by party code
Authorizations:
path Parameters
partyCode required | integer <int32> (PartyCodeQueryParam) Example: 1000001 Targeted party code |
Responses
Response samples
- 200
- 401
- 404
- 500
[- {
- "code": 100023,
- "partyCode": 1000032,
- "functionalRef": "B1234",
- "name": "Euromaster Kepler",
- "active": true,
- "addressLine1": "Industrichone",
- "addressLine2": null,
- "addressLine3": null,
- "postalCode": "42697",
- "city": "Solingen",
- "subdivision": "Castelló",
- "countryCode": "ES",
- "legalIdentifier": {
- "siret": "36252187900034"
}, - "lastModifiedDate": "2024-12-27T12:23:23"
}, - {
- "code": 100024,
- "partyCode": 1000033,
- "functionalRef": "B1234",
- "name": "Euromaster Neumarkt",
- "active": true,
- "addressLine1": "Industrichone",
- "addressLine2": null,
- "addressLine3": null,
- "postalCode": "92318",
- "city": "Neumarkt",
- "subdivision": "Castelló",
- "countryCode": "ES",
- "legalIdentifier": {
- "siret": "36252187900034"
}, - "lastModifiedDate": "2024-12-27T12:23:23"
}
]
Add bank account
Add bank account by party code
Authorizations:
path Parameters
partyCode required | integer <int32> (PartyCodeQueryParam) Example: 1000001 Targeted party code |
Request Body schema: application/json
owner | string (owner) <= 255 characters Owner of the bank account |
bankName | string (bankName) <= 255 characters Name of the bank |
bankKey | string (bankKey) <= 255 characters Key of the bank |
countryCode | string (countryCode) <= 255 characters The country code of the address |
number | string (bankAccountNumber) <= 255 characters Number of the bank account |
iban | string (iban) <= 255 characters International Bank Account Number |
controlKey | string (controlKey) <= 255 characters Key to validate or identify the account |
bic | string (bic) <= 255 characters Code to identify the bank |
Responses
Request samples
- Payload
Create a bank account with the given informations
{- "owner": "John Doe",
- "bankName": "Bank",
- "bankKey": "1234",
- "countryCode": "FR",
- "number": "123456789",
- "iban": "FR123456789",
- "controlKey": "1234",
- "bic": "BANK000FR"
}
Response samples
- 400
- 401
- 404
- 500
{- "errors": [
- {
- "error": "string",
- "property": "string"
}
]
}
Get bank account
Get bank account by party code
Authorizations:
path Parameters
partyCode required | integer <int32> (PartyCodeQueryParam) Example: 1000001 Targeted party code |
Responses
Response samples
- 200
- 400
- 401
- 404
- 500
{- "owner": "John Doe",
- "bankName": "Bank",
- "bankKey": "1234",
- "countryCode": "FR",
- "number": "123456789",
- "iban": "FR123456789",
- "controlKey": "1234",
- "bic": "BANK000FR"
}
Response samples
- 200
- 401
- 404
- 500
{- "code": 1020202,
- "name": "SARL BTP PRADELS",
- "functionalRef": "B1234",
- "type": "B2B",
- "active": true,
- "membership": "Association Charade",
- "legalIdentifier": {
- "siren": "824393151",
- "nif": "X9956748M",
- "VATNumber": "FR50824393151"
}, - "lastModifiedDate": "2024-12-27T12:23:23",
- "lastModifiedBy": "user1"
}
Get sites for the current user
Retrieve sites by party of the current user
Authorizations:
query Parameters
pageNumber | integer <int32> (PageNumberQueryParam) [ 1 .. 1000 ] Default: 1 Example: pageNumber=2 The page number |
pageSize | integer <int32> (PageSizeQueryParam) [ 1 .. 1000 ] Default: 1000 Example: pageSize=2 The page size |
Responses
Response samples
- 200
- 401
- 404
- 500
{- "pagination": {
- "next": "/party-erm/v1/parties/me/sites?page=2&size=50",
- "previous": "/party-erm/v1/parties/me/sites?page=1&size=50",
- "pageTotal": "3",
- "totalElements": "125"
}, - "sites": [
- {
- "code": 100023,
- "partyCode": 1000032,
- "functionalRef": "B1234",
- "name": "Euromaster Kepler",
- "active": true,
- "addressLine1": "Industrichone",
- "addressLine2": null,
- "addressLine3": null,
- "postalCode": "42697",
- "city": "Solingen",
- "subdivision": "Castelló",
- "countryCode": "ES",
- "legalIdentifier": {
- "siret": "36252187900034"
}, - "lastModifiedDate": "2024-12-27T12:23:23"
}, - {
- "code": 100024,
- "partyCode": 1000033,
- "functionalRef": "B1234",
- "name": "Euromaster Neumarkt",
- "active": true,
- "addressLine1": "Industrichone",
- "addressLine2": null,
- "addressLine3": null,
- "postalCode": "92318",
- "city": "Neumarkt",
- "subdivision": "Castelló",
- "countryCode": "ES",
- "legalIdentifier": {
- "siret": "36252187900034"
}, - "lastModifiedDate": "2024-12-27T12:23:23"
}
]
}
Returns a list of users associated with the current authenticated user's party
This endpoint allows filtering, sorting, and pagination depending on implementation. It is typically used to retrieve all users belonging to my party for administrative or integration purposes. Proper authorization is required to access my party’s user list.
Authorizations:
query Parameters
pageNumber | integer <int32> (PageNumberQueryParam) [ 1 .. 1000 ] Default: 1 Example: pageNumber=2 The page number |
pageSize | integer <int32> (PageSizeQueryParam) [ 1 .. 1000 ] Default: 1000 Example: pageSize=2 The page size |
withInactive | boolean (WithInactiveQueryParam) Default: false Example: withInactive=true Include inactive users |
Responses
Response samples
- 200
- 400
- 401
- 403
- 404
- 500
{- "pagination": {
- "next": "/party-erm/v1/parties/me/users?page=3&size=50",
- "previous": "/party-erm/v1/parties/me/users?page=1&size=50",
- "pageTotal": "3",
- "totalElements": "125"
}, - "users": [
- {
- "code": 100001,
- "userName": "firstname.lastname@company.com",
- "firstName": "Firstname",
- "lastName": "Lastname",
- "active": true,
- "language": "fr-FR",
- "partyCode": 100001,
- "roles": [
- {
- "code": "INSPECTOR"
}, - {
- "code": "TECHNICIAN"
}
], - "lastModifiedDate": "2024-12-27T12:23:23",
- "lastModifiedBy": "user1"
}, - {
- "code": 100002,
- "userName": "firstname.lastname@company.com",
- "firstName": "Firstname",
- "lastName": "Lastname",
- "active": true,
- "language": "fr-FR",
- "partyCode": 100001,
- "roles": [
- {
- "code": "INSPECTOR"
}
], - "lastModifiedDate": "2024-12-27T12:23:23",
- "lastModifiedBy": "user2"
}
]
}
Get contacts for the current user
Retrieve contacts by party of the current user
Authorizations:
query Parameters
pageNumber | integer <int32> (PageNumberQueryParam) [ 1 .. 1000 ] Default: 1 Example: pageNumber=2 The page number |
pageSize | integer <int32> (PageSizeQueryParam) [ 1 .. 1000 ] Default: 1000 Example: pageSize=2 The page size |
Responses
Response samples
- 200
- 401
- 404
- 500
{- "pagination": {
- "next": "/party-erm/v1/parties/me/contacts?page=3&size=50",
- "previous": "/party-erm/v1/parties/me/contacts?page=1&size=50",
- "pageTotal": "1",
- "totalElements": "125"
}, - "contacts": [
- {
- "code": "100111",
- "title": "M",
- "firstName": "Rémi",
- "lastName": "PRADELS",
- "secondLastName": null,
- "nationalIdentificationNumber": "12345678E",
- "email": "remi.pradels@gmail.com",
- "phoneNumber": null,
- "mobilePhoneNumber": "0682616339",
- "birthDate": null,
- "communicationChannel": {
- "sms": {
- "authorized": true,
- "marketingConsent": true,
- "consentDate": "2024-09-10"
}, - "email": {
- "authorized": true,
- "marketingConsent": true,
- "consentDate": "2024-09-11"
}, - "postal": {
- "authorized": true,
- "marketingConsent": true,
- "consentDate": "2024-09-12"
}
}, - "gdpr": {
- "signed": null,
- "signedDate": null
}, - "lastModifiedDate": "2024-12-27:12:23:23",
- "lastModifiedBy": "florent.buhot@euromaster.com"
}
]
}
Get sites data
Get sites data filtered by parameters
Authorizations:
query Parameters
pageNumber | integer <int32> (PageNumberQueryParam) [ 1 .. 1000 ] Default: 1 Example: pageNumber=2 The page number |
pageSize | integer <int32> (PageSizeQueryParam) [ 1 .. 1000 ] Default: 1000 Example: pageSize=2 The page size |
lastModifiedDateFrom | string <date-time> (LastModifiedDateFromQueryParam) Example: lastModifiedDateFrom=2024-05-02T10:00:00 Date from for last update date of data |
lastModifiedDateTo | string <date-time> (LastModifiedDateToQueryParam) Example: lastModifiedDateTo=2024-05-02T10:00:00 Date to for last update date of data |
name | string (name) <= 255 characters Example: name=Euromaster Kepler The value contained in the site's name |
functionalRef | string (functionalRef) <= 255 characters Example: functionalRef=B1234 functional ref of the site |
externalRef | string (externalRef) <= 255 characters Example: externalRef=12345678 external ref of the site |
source | string (source) <= 255 characters Example: source=GENES source of the site |
withInactive | boolean (WithInactiveQueryParam) Default: false Example: withInactive=true Retrieve inactive site or not |
withExternalRef | boolean (WithExternalRefQueryParam) Default: false Example: withExternalRef=true Retrieve external ref data or not |
codes | Array of integers <int64> (SiteCodeListQueryParameter) [ 1 .. 100 ] items [ items <int64 > ] Example: codes=123,234 List of site code |
Responses
Response samples
- 200
- 400
- 401
- 404
- 500
{- "pagination": {
- "next": "/party-erm/v1/sites?page=3&size=50",
- "previous": "/party-erm/v1/sites?page=1&size=50",
- "pageTotal": "3",
- "totalElements": "125"
}, - "sites": [
- {
- "partyCode": 100001,
- "code": 100023,
- "functionalRef": "B1234",
- "active": true,
- "name": "Euromaster Kepler",
- "addressLine1": "Industrichone",
- "addressLine2": null,
- "addressLine3": null,
- "postalCode": "42697",
- "city": "Solingen",
- "subdivision": null,
- "countryCode": "DE",
- "lastModifiedDate": "2024-12-27:12:23:23",
- "references": [
- {
- "source": "ES_EQUITY",
- "externalRef": "20831238",
- "countryCode": "ES",
- "lastModifiedDate": "2024-12-27:12:23:23"
}
]
}
]
}
Create a site.
This endpoint allows to create a site.
Authorizations:
Request Body schema: application/json
partyCode required | integer <int64> (partyCode) Party code of the source |
functionalRef | string (functionalRef) <= 255 characters Functional reference identifier |
name required | string (name) <= 255 characters The name |
addressLine1 | string (addressLine1) <= 255 characters The first line of the address |
addressLine2 | string (addressLine2) <= 255 characters The second line of the address |
addressLine3 | string (addressLine3) <= 255 characters The third line of the address |
postalCode | string (postalCode) <= 255 characters The postal code of the address |
city | string (city) <= 255 characters The city of the address |
subdivision | string (subdivision) <= 255 characters The subdivision (e.g., state, province) of the address |
countryCode required | string (countryCode) <= 255 characters The country code of the address |
Responses
Request samples
- Payload
{- "partyCode": 1000032,
- "functionalRef": "B1234",
- "name": "Euromaster Kepler",
- "addressLine1": "Industrichone",
- "addressLine2": null,
- "addressLine3": null,
- "postalCode": "42697",
- "city": "Solingen",
- "subdivision": null,
- "countryCode": "DE"
}
Response samples
- 200
- 400
- 401
- 500
{- "code": 100023,
- "partyCode": 1000032,
- "functionalRef": "B1234",
- "active": true,
- "name": "Euromaster Kepler",
- "addressLine1": "Industrichone",
- "addressLine2": null,
- "addressLine3": null,
- "postalCode": "42697",
- "city": "Solingen",
- "subdivision": null,
- "countryCode": "DE",
- "lastModifiedDate": "2024-12-27:12:23:23"
}
Create site data
Create site external
Authorizations:
Request Body schema: application/json
partyCode required | integer <int64> (partyCode) Party code of the source |
externalRef required | string (externalRef) <= 255 characters External reference identifier |
functionalRef | string (functionalRef) <= 255 characters Functional reference identifier |
name | string (name) <= 255 characters The name |
object (SiteLegalIdentifierDTO) Legal identifier information | |
addressLine1 | string (addressLine1) <= 255 characters The first line of the address |
addressLine2 | string (addressLine2) <= 255 characters The second line of the address |
addressLine3 | string (addressLine3) <= 255 characters The third line of the address |
postalCode | string (postalCode) <= 255 characters The postal code of the address |
city | string (city) <= 255 characters The city of the address |
subdivision | string (subdivision) <= 255 characters The subdivision (e.g., state, province) of the address |
countryCode required | string (countryCode) <= 255 characters The country code of the address |
Responses
Request samples
- Payload
Create a site with the given informations
{- "externalRef": "UIOZE",
- "partyCode": 1000032,
- "functionalRef": "B1234",
- "name": "Euromaster Kepler",
- "legalIdentifier": {
- "siret": "123456789"
}, - "addressLine1": "Industrichone",
- "addressLine2": null,
- "addressLine3": null,
- "postalCode": "42697",
- "city": "Solingen",
- "subdivision": null,
- "countryCode": "DE"
}
Response samples
- 200
- 400
- 401
- 404
- 500
{- "code": 10001111
}
Get a site
Retrieve a site by his code
Authorizations:
path Parameters
siteCode required | integer <int64> (SiteCodeQueryParam) Example: 1000032 Targeted site code |
Responses
Response samples
- 200
- 401
- 404
- 500
{- "code": 100023,
- "partyCode": 1000032,
- "functionalRef": "B1234",
- "active": true,
- "name": "Euromaster Kepler",
- "addressLine1": "Industrichone",
- "addressLine2": null,
- "addressLine3": null,
- "postalCode": "42697",
- "city": "Solingen",
- "subdivision": null,
- "countryCode": "DE",
- "lastModifiedDate": "2024-12-27:12:23:23"
}
Update a site
Update a site by his code
Authorizations:
path Parameters
siteCode required | integer <int64> (SiteCodeQueryParam) Example: 1000032 Targeted site code |
Request Body schema: application/json
partyCode required | integer <int64> (partyCode) Party code of the source |
functionalRef | string (functionalRef) <= 255 characters Functional reference identifier |
name required | string (name) <= 255 characters The name |
addressLine1 | string (addressLine1) <= 255 characters The first line of the address |
addressLine2 | string (addressLine2) <= 255 characters The second line of the address |
addressLine3 | string (addressLine3) <= 255 characters The third line of the address |
postalCode | string (postalCode) <= 255 characters The postal code of the address |
city | string (city) <= 255 characters The city of the address |
subdivision | string (subdivision) <= 255 characters The subdivision (e.g., state, province) of the address |
countryCode required | string (countryCode) <= 255 characters The country code of the address |
Responses
Request samples
- Payload
{- "partyCode": "1000032",
- "functionalRef": "B1234",
- "name": "Euromaster Kepler",
- "addressLine1": "Industrichone",
- "addressLine2": null,
- "addressLine3": null,
- "postalCode": "42697",
- "city": "Solingen",
- "subdivision": null,
- "countryCode": "DE"
}
Response samples
- 200
- 401
- 404
- 500
{- "code": 100023,
- "partyCode": 1000032,
- "functionalRef": "B1234",
- "active": true,
- "name": "Euromaster Kepler",
- "addressLine1": "Industrichone",
- "addressLine2": null,
- "addressLine3": null,
- "postalCode": "42697",
- "city": "Solingen",
- "subdivision": null,
- "countryCode": "DE",
- "lastModifiedDate": "2024-12-27:12:23:23"
}
Delete a site
Update a site to set his active attribute to false
Authorizations:
path Parameters
siteCode required | integer <int64> (SiteCodeQueryParam) Example: 1000032 Targeted site code |
Responses
Response samples
- 404
- 500
{- "errors": [
- {
- "error": "The site code XXABCXX cannot be found",
- "property": "siteCode"
}
]
}
Get offers data
Get offers data filtered by parameters
Authorizations:
query Parameters
category | string (CategoryQueryParam) <= 255 characters Example: category=CUSTOMER The category of the offer |
partyType | string (PartyTypeQueryParam) <= 255 characters Example: partyType=B2B The type of the party |
type | string (OfferTypeQueryParam) <= 255 characters Example: type=PROSPECTING The type of the offer |
vehicleCategory | string (VehicleCategoryQueryParam) <= 255 characters Example: vehicleCategory=TRUCK The category of the vehicle |
Responses
Response samples
- 200
- 400
- 401
- 500
[- {
- "code": 100000,
- "active": true,
- "name": "Master Care+",
- "category": "CUSTOMER",
- "partyType": "B2B",
- "type": "PROSPECTING",
- "vehicleCategory": "TRUCK",
- "lastModifiedDate": "2024-12-27T12:23:23",
- "lastModifiedBy": "user1"
}, - {
- "code": 100001,
- "active": true,
- "name": "Master Premium",
- "category": "CUSTOMER",
- "partyType": "B2B",
- "type": "TRANSACTIONAL",
- "vehicleCategory": "TRUCK",
- "lastModifiedDate": "2024-12-27T12:23:23",
- "lastModifiedBy": "user2"
}
]
Get an offer
Retrieve an offer by its code
Authorizations:
path Parameters
code required | integer <int64> (offerCode) Example: 100000 Targeted offer code |
Responses
Response samples
- 200
- 401
- 404
- 500
{- "code": 100001,
- "active": true,
- "name": "Master Premium",
- "category": "CUSTOMER",
- "partyType": "B2B",
- "type": "TRANSACTIONAL",
- "vehicleCategory": "TRUCK",
- "lastModifiedDate": "2024-12-27T12:23:23",
- "lastModifiedBy": "user2"
}
Create a subscription.
This endpoint allows to create a subscription.
Authorizations:
Request Body schema: application/json
contractorCode required | integer <int64> (partyCode) Party code of the source |
customerCode required | integer <int64> (partyCode) Party code of the source |
offerCode required | integer <int64> (offerCode) Offer code |
startDate | string <date> (startDateSubscription) Start date of the subscription in YYYY-MM-DD format |
endDate | string <date> (endDateSubscription) End date of the subscription in YYYY-MM-DD format |
inspectionFrequency | integer <int32> (inspectionFrequency) Frequency of inspections in days |
pressure | boolean (pressure) Indicates if the pressure is taken |
resale | boolean (resale) Indicates if the party is for resale |
nonResale | boolean (nonResale) Indicates if the party is for non resale |
requiredPO | boolean (requiredPO) Indicates if a Purchase Order (PO) is required for this party |
glAccount | integer <int64> (glAccount) GL account linked to the supplier |
Array of objects List of subscription lines |
Responses
Request samples
- Payload
{- "contractorCode": 900000,
- "customerCode": 900001,
- "offerCode": 100000,
- "startDate": "2024-03-01",
- "endDate": "2026-03-01",
- "inspectionFrequency": 90,
- "pressure": true,
- "resale": false,
- "nonResale": false,
- "requiredPO": false,
- "glAccount": 607,
- "lines": [
- {
- "customerSiteCode": 900000,
- "inspectionServiceProviderCode": 900002
}, - {
- "customerSiteCode": 900001,
- "inspectionServiceProviderCode": 900003
}
]
}
Response samples
- 200
- 400
- 401
- 404
- 409
- 500
{- "code": 100023,
- "contractorCode": 900000,
- "customerCode": 900001,
- "offerCode": 100000,
- "startDate": "2024-03-01",
- "endDate": "2026-03-01",
- "active": true,
- "inspectionFrequency": 90,
- "pressure": true,
- "resale": false,
- "nonResale": false,
- "requiredPO": false,
- "lastModifiedDate": "2024-12-27T12:23:23",
- "glAccount": 607,
- "lines": [
- {
- "customerSiteCode": 900000,
- "inspectionServiceProviderCode": 900002
}, - {
- "customerSiteCode": 900001,
- "inspectionServiceProviderCode": 900003
}
]
}
Get subscriptions data
Get subscriptions data filtered by parameters
Authorizations:
query Parameters
pageNumber | integer <int32> (PageNumberQueryParam) [ 1 .. 1000 ] Default: 1 Example: pageNumber=2 The page number |
pageSize | integer <int32> (PageSizeQueryParam) [ 1 .. 1000 ] Default: 1000 Example: pageSize=2 The page size |
lastModifiedDateFrom | string <date-time> (LastModifiedDateFromQueryParam) Example: lastModifiedDateFrom=2024-05-02T10:00:00 Date from for last update date of data |
lastModifiedDateTo | string <date-time> (LastModifiedDateToQueryParam) Example: lastModifiedDateTo=2024-05-02T10:00:00 Date to for last update date of data |
contractorCode | integer <int32> (PartyCodeQueryParam) Example: contractorCode=1000001 Contractor party code |
customerCode | integer <int32> (PartyCodeQueryParam) Example: customerCode=1000001 Customer party code |
offerCode | Array of integers <int64> (OfferCodeListQueryParameter) [ 1 .. 100 ] items [ items <int64 > ] Example: offerCode=123,234 List of offer codes |
startDate | string <date> (startDateSubscription) Example: startDate=2024-01-01 Start date of the subscription |
endDate | string <date> (endDateSubscription) Example: endDate=2025-01-01 End date of the subscription |
withInactive | boolean (WithInactiveQueryParam) Default: false Example: withInactive=true If filled then return active and inactive subscriptions |
customerSiteCode | Array of integers <int64> (SiteCodeListQueryParameter) [ 1 .. 100 ] items [ items <int64 > ] Example: customerSiteCode=123,234 List of customer site codes |
Responses
Response samples
- 200
- 400
- 401
- 404
- 500
{- "pagination": {
- "next": "/party-erm/v1/subscriptions?page=3&size=50",
- "previous": "/party-erm/v1/subscriptions?page=1&size=50",
- "pageTotal": "3",
- "totalElements": "125"
}, - "subscriptions": [
- {
- "code": 100023,
- "contractorCode": 900000,
- "customerCode": 900001,
- "offerCode": 100000,
- "startDate": "2024-03-01",
- "endDate": "2026-03-01",
- "active": true,
- "inspectionFrequency": 90,
- "pressure": true,
- "resale": false,
- "nonResale": false,
- "requiredPO": false,
- "glAccount": 607,
- "lastModifiedDate": "2024-12-27T12:23:23",
- "lines": [
- {
- "customerSiteCode": 900000,
- "inspectionServiceProviderCode": 900002
}, - {
- "customerSiteCode": 900001,
- "inspectionServiceProviderCode": 900003
}
]
}
]
}
Get a subscription
Retrieve a subscription by its code
Authorizations:
path Parameters
subscriptionCode required | integer <int64> (SubscriptionCodeParam) Example: 100000 Targeted subscription code |
Responses
Response samples
- 200
- 401
- 404
- 500
{- "code": 100023,
- "contractorCode": 900000,
- "customerCode": 900001,
- "offerCode": 100000,
- "startDate": "2024-03-01",
- "endDate": "2026-03-01",
- "active": true,
- "inspectionFrequency": 90,
- "pressure": true,
- "lastModifiedDate": "2024-12-27T12:23:23"
}
Update a subscription
Update a subscription by its code
Authorizations:
path Parameters
subscriptionCode required | integer <int64> (SubscriptionCodeParam) Example: 100000 Targeted subscription code |
Request Body schema: application/json
offerCode required | integer <int64> (offerCode) Offer code |
startDate | string <date> (startDateSubscription) Start date of the subscription in YYYY-MM-DD format |
endDate | string <date> (endDateSubscription) End date of the subscription in YYYY-MM-DD format |
inspectionFrequency | integer <int32> (inspectionFrequency) Frequency of inspections in days |
pressure | boolean (pressure) Indicates if the pressure is taken |
resale | boolean (resale) Indicates if the party is for resale |
nonResale | boolean (nonResale) Indicates if the party is for non resale |
requiredPO | boolean (requiredPO) Indicates if a Purchase Order (PO) is required for this party |
glAccount | integer <int64> (glAccount) GL account linked to the supplier |
Responses
Request samples
- Payload
{- "offerCode": 1000002,
- "startDate": "2024-03-01",
- "endDate": "2026-03-01",
- "inspectionFrequency": 90,
- "pressure": true,
- "resale": false,
- "nonResale": false,
- "requiredPO": false,
- "glAccount": 607
}
Response samples
- 200
- 401
- 404
- 500
{- "code": 1000000,
- "contractorCode": 1000000,
- "customerCode": 1000001,
- "offerCode": 1000002,
- "startDate": "2024-03-01",
- "endDate": "2026-03-01",
- "active": true,
- "inspectionFrequency": 90,
- "pressure": true,
- "resale": false,
- "nonResale": false,
- "requiredPO": false,
- "glAccount": 607,
- "lastModifiedDate": "2024-12-27T12:23:23"
}
Add a line to a subscription
This endpoint allows to add a line to a subscription.
Authorizations:
path Parameters
subscriptionCode required | integer <int64> (SubscriptionCodeParam) Example: 100000 Targeted subscription code |
customerSiteCode required | integer <int64> (CustomerSiteCodeParam) Example: 100000 Targeted customer site code |
Request Body schema: application/json
inspectionServiceProviderCode required | integer <int64> (partyCode) Party code of the source |
Responses
Request samples
- Payload
{- "inspectionServiceProviderCode": 1000032
}
Response samples
- 200
- 400
- 401
- 404
- 409
- 500
{- "customerSiteCode": 10001111,
- "inspectionServiceProviderCode": 10002222
}
Update a subscription line
This endpoint allows to update a subscription line.
Authorizations:
path Parameters
subscriptionCode required | integer <int64> (SubscriptionCodeParam) Example: 100000 Targeted subscription code |
customerSiteCode required | integer <int64> (CustomerSiteCodeParam) Example: 100000 Targeted customer site code |
Request Body schema: application/json
inspectionServiceProviderCode required | integer <int64> (partyCode) Party code of the source |
Responses
Request samples
- Payload
{- "inspectionServiceProviderCode": 1000032
}
Response samples
- 200
- 400
- 401
- 404
- 409
- 500
{- "customerSiteCode": 10001111,
- "inspectionServiceProviderCode": 10002222
}
Get all my subscriptions as a customer
Get all my subscriptions as a customer and as an authenticated user associated to a Party
Authorizations:
query Parameters
pageNumber | integer <int32> (PageNumberQueryParam) [ 1 .. 1000 ] Default: 1 Example: pageNumber=2 The page number |
pageSize | integer <int32> (PageSizeQueryParam) [ 1 .. 1000 ] Default: 1000 Example: pageSize=2 The page size |
lastModifiedDateFrom | string <date-time> (LastModifiedDateFromQueryParam) Example: lastModifiedDateFrom=2024-05-02T10:00:00 Date from for last update date of data |
lastModifiedDateTo | string <date-time> (LastModifiedDateToQueryParam) Example: lastModifiedDateTo=2024-05-02T10:00:00 Date to for last update date of data |
contractorCode | integer <int32> (PartyCodeQueryParam) Example: contractorCode=1000001 Contractor party code |
offerCode | integer <int64> (offerCode) Example: offerCode=100000 Offer code |
withInactive | boolean (WithInactiveQueryParam) Default: false Example: withInactive=true If filled then return active and inactive subscriptions |
Responses
Response samples
- 200
- 400
- 401
- 404
- 500
{- "pagination": {
- "next": "/party-erm/v1/subscriptions-as-customer?page=3&size=50",
- "previous": "/party-erm/v1/subscriptions-as-customer?page=1&size=50",
- "pageTotal": "3",
- "totalElements": "125"
}, - "subscriptions": [
- {
- "code": 100023,
- "active": true,
- "contractorCode": 900000,
- "customerCode": 900001,
- "offerCode": 100000,
- "startDate": "2024-03-01",
- "endDate": "2026-03-01",
- "inspectionFrequency": 90,
- "pressure": true,
- "resale": false,
- "nonResale": false,
- "requiredPO": false,
- "glAccount": 607,
- "commercialAgreement": "offreSmall_MCP1",
- "paymentType": "CASH",
- "lastModifiedDate": "2024-12-27T12:23:23",
- "lastModifiedBy": "user1"
}
]
}
Get detailed lines for a specific subscription
Get detailed lines for a specific subscription for which I am a customer and an authenticated user associated with a party
Authorizations:
path Parameters
subscriptionCode required | integer <int64> (SubscriptionCodeParam) Example: 100000 Targeted subscription code |
query Parameters
pageNumber | integer <int32> (PageNumberQueryParam) [ 1 .. 1000 ] Default: 1 Example: pageNumber=2 The page number |
pageSize | integer <int32> (PageSizeQueryParam) [ 1 .. 1000 ] Default: 1000 Example: pageSize=2 The page size |
Responses
Response samples
- 200
- 400
- 401
- 404
- 500
{- "pagination": {
- "next": "/subscriptions-as-customer/100001/lines?page=3&size=50",
- "previous": "/subscriptions-as-customer/100001/lines?page=1&size=50",
- "pageTotal": 3,
- "totalElements": 125
}, - "lines": [
- {
- "customerSiteCode": 100001,
- "inspectionServiceProviderCode": 100003,
- "billToCode": 100005,
- "lastModifiedDate": "2025-07-10T14:30:00",
- "lastModifiedBy": "user1"
}
]
}
Get commercial agreement for a specific subscription
Get commercial agreement for a specific subscription for which I am a customer and an authenticated user associated with a party
Authorizations:
path Parameters
subscriptionCode required | integer <int64> (SubscriptionCodeParam) Example: 100000 Targeted subscription code |
Responses
Response samples
- 400
- 401
- 404
- 500
{- "errors": [
- {
- "error": "string",
- "property": "string"
}
]
}
Get all my subscriptions as a contractor
Get all my subscriptions as a contractor and as an authenticated user associated to a Party
Authorizations:
query Parameters
pageNumber | integer <int32> (PageNumberQueryParam) [ 1 .. 1000 ] Default: 1 Example: pageNumber=2 The page number |
pageSize | integer <int32> (PageSizeQueryParam) [ 1 .. 1000 ] Default: 1000 Example: pageSize=2 The page size |
customerCode | integer <int32> (PartyCodeQueryParam) Example: customerCode=1000001 Customer party code |
offerCode | integer <int64> (offerCode) Example: offerCode=100000 Offer code |
lastModifiedDateFrom | string <date-time> (LastModifiedDateFromQueryParam) Example: lastModifiedDateFrom=2024-05-02T10:00:00 Date from for last update date of data |
lastModifiedDateTo | string <date-time> (LastModifiedDateToQueryParam) Example: lastModifiedDateTo=2024-05-02T10:00:00 Date to for last update date of data |
withInactive | boolean (WithInactiveQueryParam) Default: false Example: withInactive=true If filled then return active and inactive subscriptions |
Responses
Response samples
- 200
- 400
- 401
- 404
- 500
{- "pagination": {
- "next": "/party-erm/v1/subscriptions-as-contractor?page=3&size=50",
- "previous": "/party-erm/v1/subscriptions-as-contractor?page=1&size=50",
- "pageTotal": "3",
- "totalElements": "125"
}, - "subscriptions": [
- {
- "code": 100023,
- "active": true,
- "contractorCode": 900000,
- "customerCode": 900001,
- "offerCode": 100000,
- "startDate": "2024-03-01",
- "endDate": "2026-03-01",
- "inspectionFrequency": 90,
- "pressure": true,
- "resale": false,
- "nonResale": false,
- "requiredPO": false,
- "glAccount": 607,
- "commercialAgreement": "offreSmall_MCP1",
- "paymentType": "CASH",
- "lastModifiedDate": "2024-12-27T12:23:23",
- "lastModifiedBy": "user1"
}
]
}
Get lines for a contractor's subscription
Get detailed lines for a specific subscription for which I am a contractor and an authenticated user associated with a party
Authorizations:
path Parameters
subscriptionCode required | integer <int64> (SubscriptionCodeParam) Example: 100000 The subscription code |
query Parameters
pageNumber | integer <int32> (PageNumberQueryParam) [ 1 .. 1000 ] Default: 1 Example: pageNumber=2 The page number |
pageSize | integer <int32> (PageSizeQueryParam) [ 1 .. 1000 ] Default: 1000 Example: pageSize=2 The page size |
Responses
Response samples
- 200
- 400
- 401
- 404
- 500
{- "pagination": {
- "next": "/party-erm/v1/subscriptions-as-contractor/100001/lines?page=3&size=50",
- "previous": "/party-erm/v1/subscriptions-as-contractor/100001/lines?page=1&size=50",
- "pageTotal": "3",
- "totalElements": "125"
}, - "lines": [
- {
- "customerSiteCode": 100001,
- "inspectionServiceProviderCode": 100003,
- "billToCode": 100005,
- "lastModifiedDate": "2025-07-10T14:30:00",
- "lastModifiedBy": "user1"
}
]
}
Delete a line for a specific subscription
Delete a line for a specific subscription for which I am a contractor and an authenticated user associated with a party
Authorizations:
path Parameters
subscriptionCode required | integer <int64> (SubscriptionCodeParam) Example: 100000 Targeted subscription code |
customerSiteCode required | integer <int64> (CustomerSiteCodeParam) Example: 100000 Targeted customer site code |
Responses
Response samples
- 404
- 500
{- "errors": [
- {
- "error": "The user cannot be found",
- "property": "clientId"
}
]
}
Get users data
Get users data filtered by parameters
Authorizations:
query Parameters
pageNumber | integer <int32> (PageNumberQueryParam) [ 1 .. 1000 ] Default: 1 Example: pageNumber=2 The page number |
pageSize | integer <int32> (PageSizeQueryParam) [ 1 .. 1000 ] Default: 1000 Example: pageSize=2 The page size |
hasCompany | boolean (HasCompanyQueryParam) Default: true Example: hasCompany=true Filter users by company association |
Responses
Response samples
- 200
- 400
- 401
- 404
- 500
{- "pagination": {
- "next": "/party-erm/v1/parties/extended?page=3&size=50",
- "previous": "/party-erm/v1/parties/extended?page=1&size=50",
- "pageTotal": "3",
- "totalElements": "125"
}, - "users": [
- {
- "code": 100001,
- "userName": "pierre.martin@email.com",
- "firstName": "Pierre",
- "lastName": "Martin",
- "active": true,
- "language": "fr-FR",
- "roles": [
- {
- "code": "INSPECTOR"
}, - {
- "code": "CONTRACTOR"
}
], - "partyCode": 1000726,
- "lastModifiedDate": "2024-12-27T12:23:23"
}
]
}
Response samples
- 200
- 401
- 404
- 500
{- "code": 100001,
- "userName": "pierre.martin@email.com",
- "firstName": "Pierre",
- "lastName": "Martin",
- "active": true,
- "language": "fr-FR",
- "roles": [
- {
- "code": "INSPECTOR"
}, - {
- "code": "CONTRACTOR"
}
], - "partyCode": 1000726,
- "lastModifiedDate": "2024-12-27T12:23:23"
}
Update a user
Update a user by his code
Authorizations:
path Parameters
userCode required | integer <int64> (userCode) Example: 1000032 Targeted user code |
Request Body schema: application/json
language | string (language) <= 255 characters Language of the translation (e.g. 'nl-NL', 'fr-FR') |
Array of objects List of role |
Responses
Request samples
- Payload
{- "language": "fr-FR",
- "roles": [
- {
- "code": "INSPECTOR"
}, - {
- "code": "CONTRACTOR"
}
]
}
Response samples
- 200
- 400
- 401
- 404
- 500
{- "code": 1000000
}
Quick search customers data for which my company is assigned as Inspector service provider.
List of customers for which my company is assigned as Inspector service provider. Maximum number of results limited to 100.
Authorizations:
query Parameters
name required | string (CustomerNameQueryParam) [ 1 .. 100 ] characters Example: name=Euromaster The value contained in the customer's name |
Responses
Response samples
- 200
- 400
- 401
- 404
- 500
[- {
- "code": 100001,
- "name": "EUROMASTER SERVICE ET MANAGEMENT"
}, - {
- "code": 100006,
- "name": "TRANSPORT NICOLAS"
}
]
Get a customer for which my company is assign as Inpector service provider
Get a customer for which my company is assign as Inpector service provider
Authorizations:
path Parameters
partyCode required | integer <int32> (PartyCodeQueryParam) Example: 1000001 Refers to an end-customer |
Responses
Response samples
- 200
- 401
- 403
- 404
- 500
{- "code": 1020202,
- "name": "SARL BTP PRADELS",
- "functionalRef": "B1234",
- "type": "B2B",
- "active": true,
- "membership": "Association Charade",
- "legalIdentifier": {
- "siren": "824393151",
- "nif": "X9956748M",
- "VATNumber": "FR50824393151"
}, - "lastModifiedDate": "2024-12-27T12:23:23",
- "lastModifiedBy": "user1"
}
Get my end-customers sites as Inspector service provider.
Get my end-customers sites as Inspector service provider.
Authorizations:
path Parameters
partyCode required | integer <int32> (PartyCodeQueryParam) Example: 1000001 Targeted party code |
query Parameters
pageNumber | integer <int32> (PageNumberQueryParam) [ 1 .. 1000 ] Default: 1 Example: pageNumber=2 The page number |
pageSize | integer <int32> (PageSizeQueryParam) [ 1 .. 1000 ] Default: 1000 Example: pageSize=2 The page size |
name | string (CustomerNameQueryParam) [ 1 .. 100 ] characters Example: name=Euromaster The value contained in the customer's name |
withInactive | boolean (WithInactiveQueryParam) Default: false Example: withInactive=true If filled then return active and inactive parties (default false) |
Responses
Response samples
- 200
- 400
- 401
- 403
- 404
- 500
{- "pagination": {
- "next": "/party-erm/v1/inspector-customers/1000000/sites?page=2&size=50",
- "previous": "/party-erm/v1/inspector-customers/1000000/sites?page=1&size=50",
- "pageTotal": "3",
- "totalElements": "125"
}, - "sites": [
- {
- "code": 100023,
- "name": "Euromaster Kepler",
- "legalIdentifier": {
- "siret": "36252187900034"
}, - "partyCode": 1000032,
- "functionalRef": "B1234",
- "active": true,
- "addressLine1": "Industrichone",
- "addressLine2": null,
- "addressLine3": null,
- "postalCode": "42697",
- "city": "Solingen",
- "subdivision": "Castelló",
- "countryCode": "ES",
- "lastModifiedDate": "2024-12-27T12:23:23",
- "lastModifiedBy": "user@email.com"
}, - {
- "code": 100024,
- "name": "Euromaster Neumarkt",
- "legalIdentifier": {
- "siret": "36252187900034"
}, - "partyCode": 1000033,
- "functionalRef": "B1234",
- "active": true,
- "addressLine1": "Industrichone",
- "addressLine2": null,
- "addressLine3": null,
- "postalCode": "92318",
- "city": "Neumarkt",
- "subdivision": "Castelló",
- "countryCode": "ES",
- "lastModifiedDate": "2024-12-27T12:23:23",
- "lastModifiedBy": "user@email.com"
}
]
}
Get a end-customer's site as inspector
Get a end-customer's site for which I'm the inspector.
Authorizations:
path Parameters
partyCode required | integer <int32> (PartyCodeQueryParam) Example: 1000001 Refers to a end-customer |
siteCode required | integer <int64> (SiteCodeQueryParam) Example: 1000032 Refers to a end-customer's site |
Responses
Response samples
- 200
- 401
- 403
- 404
- 500
{- "code": 100023,
- "partyCode": 1000032,
- "functionalRef": "B1234",
- "active": true,
- "name": "Euromaster Kepler",
- "addressLine1": "Industrichone",
- "addressLine2": null,
- "addressLine3": null,
- "postalCode": "42697",
- "city": "Solingen",
- "subdivision": null,
- "countryCode": "DE",
- "legalIdentifier": {
- "siret": "36252187900034"
}, - "lastModifiedDate": "2024-12-27:12:23:23",
- "lastModifiedBy": "user@email.com"
}
Get countries referential
Get countries referential
Authorizations:
query Parameters
language | string (languageQueryParam) <= 255 characters Example: language=fr-FR Language for translation (e.g. 'nl-NL', 'fr-FR') |
Responses
Response samples
- 200
- 400
- 401
- 500
[- {
- "code": "FR",
- "name": "France"
}
]
Get languages referential endpoint
Get languages referential
Authorizations:
query Parameters
language | string (languageQueryParam) <= 255 characters Example: language=fr-FR Language for translation |
Responses
Response samples
- 200
- 400
- 401
- 500
[- {
- "code": "fr-FR",
- "name": "French"
}, - {
- "code": "en-US",
- "name": "English"
}
]
Create contact data
Create contact external
Authorizations:
Request Body schema: application/json
externalRef required | string (externalRef) <= 255 characters External reference identifier |
siteCode | integer <int64> (siteCode) Site code of the source |
title | string (title) <= 255 characters The title of the contact (e.g., Mr., Mrs., Ms.) |
firstName | string (firstName) <= 255 characters The first name of the contact |
lastName | string (lastName) <= 255 characters The last name of the contact |
secondLastName | string (secondLastName) <= 255 characters The second last name of the contact |
string (email) <= 255 characters The email address of the contact | |
phoneNumber | string (phoneNumber) <= 255 characters The phone number of the contact |
Responses
Request samples
- Payload
Create a contact with the given informations
{- "externalRef": "CTC",
- "siteCode": 100023,
- "title": "M",
- "firstName": "John",
- "lastName": "Doe",
- "secondLastName": "Doe2",
- "email": "john.doe@mail.com",
- "phoneNumber": "00 001 1111111"
}
Response samples
- 200
- 400
- 401
- 404
- 500
{- "code": 10001111
}