Skip to main content
API docs by Redocly

Sale API - Apigee (1.0.0)

Download OpenAPI specification:Download

License: Internal usage only

Sale API documentation

Authentication & Authorization

You will need to be identified before calling any endpoints.

In order to be recognized and authorized to access our Sale 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.

Sales

Sales operation with all operation types

Get Sales data

Get sales data filtered by parameters

Authorizations:
(OAuth2ApiKeyAuth)
query Parameters
pageNumber
required
integer <int32> (PageNumberParam) [ 1 .. 1000 ]
Example: pageNumber=2

The page number

pageSize
required
integer <int32> (PageSizeParam) [ 1 .. 1000 ]
Example: pageSize=2

The page size

lastModifiedDateFrom
string <date-time> (lastModifiedDateFromParam)
Example: lastModifiedDateFrom=2024-05-02T10:00:00

Date from for last update date of data

lastModifiedDateTo
string <date-time> (lastModifiedDateToParam)
Example: lastModifiedDateTo=2024-05-02T10:00:00

Date to for last update date of data

externalRef
string (ExternalRefQueryParam) <= 255 characters
Example: externalRef=1000045

Identifier of the external reference

source
string (SourceQueryParam) <= 255 characters
Example: source=GENES

Source of the external reference

Responses

Response samples

Content type
application/json
{
  • "[object Object]": null
}

Create sale data

Create sale

Authorizations:
(OAuth2ApiKeyAuth)
Request Body schema: application/json
externalRef
required
string (ExternalRef) <= 255 characters

Source application code of the sale

billToExternalRef
string <= 255 characters

External ref of the bill to

sellerExternalRef
string (SellerExternalRef) <= 255 characters

External ref of the seller

vehicleExternalRef
string <= 255 characters

External ref of the vehicle

date
string <date-time> (SaleDate)

Date of the sale

currency
string (CurrencyEnum)
Enum: "EUR" "CHF" "GBP"
amountInclVat
number <float> (AmountInclVat)

Total amount of the sale including VAT

Array of objects (CreateSaleLineQueryDTO)

List of lines of the sale

Responses

Request samples

Content type
application/json

Create a sale with the given information

{
  • "externalRef": "12345",
  • "billToExternalRef": "AA123",
  • "sellerExternalRef": "IUA829",
  • "vehicleExternalRef": "UYT9182",
  • "date": "2024-10-10T17:31:00",
  • "currency": "EUR",
  • "amountInclVat": "100",
  • "lines": [
    ]
}

Response samples

Content type
application/json
{
  • "code": "1000293"
}