sendSimpleTransaction

POST

/rest/transactionWebService/sendSimpleTransaction

Maintainer:Martin DA COSTA NETO

Permet d’envoyer l’ensemble des éléments d’une transaction (ticket de caisse) pour historisation uniquement.

Il est à utiliser pour archiver des transactions gérées par un autre moteur promotionnel.

Ne vérifie pas les conditions d’utilisation des offres

Ne calcul pas les effets des offres

Sauvegarde le fait que le client a utilisé les offres transmises

Valide automatiquement la transaction

Il est important de prendre connaissance du chapitre concernant les montants de transactions.

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Body Params application/json

Example

{
  "DetailsRequest": {
    "nbItems": "2",
    "nbOfferNumbers": "1",
    "OfferNumberRequest": [
      {
        "offerNumber": "2558000057275"
      }
    ],
    "TransactionItemRequest": [
      {
        "allTaxesIncludedUnitPrice": "12.57",
        "discountAmount": "2",
        "ean": "111111",
        "mainReference": "PREMIER_ITEM_DE_TEST",
        "name": "MON ITEM DE TEST",
        "preTaxUnitPrice": "10.76",
        "quantity": "1",
        "storeReference": "12",
        "AccountAdvantageRequest": [
          {
            "type": "1",
            "value": "10"
          }
        ],
        "universReference": "345"
      },
      {
        "allTaxesIncludedUnitPrice": "24.99",
        "discountAmount": "0",
        "ean": "222222",
        "mainReference": "DEUXIEME_ITEM_DE_TEST",
        "name": "UN AUTRE ITEM DE TEST",
        "preTaxUnitPrice": "21.47",
        "quantity": "1"
      }
    ]
  },
  "ReceiptRequest": {
    "allTaxesIncludedAmount": "37.56",
    "cashdeskIpAddress": "127.0.0.1",
    "cashdeskNumber": "2",
    "currency": "1",
    "discountAmount": "2",
    "EntityRequest": {
      "entityIdentifier": "666666"
    },
    "IdentifierRequest": {
      "identifierType": "1",
      "identifierValue": "1234567891011"
    },
    "preTaxAmount": "34.58",
    "receiptNumber": "MON-TICKET-270925-1",
    "AccountAdvantageRequest": [
      {
        "type": "1",
        "value": "0"
      }
    ],
    "transactionDate": "27/09/2025 16:30:00"
  }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/rest/transactionWebService/sendSimpleTransaction' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "DetailsRequest": {
    "nbItems": "2",
    "nbOfferNumbers": "1",
    "OfferNumberRequest": [
      {
        "offerNumber": "2558000057275"
      }
    ],
    "TransactionItemRequest": [
      {
        "allTaxesIncludedUnitPrice": "12.57",
        "discountAmount": "2",
        "ean": "111111",
        "mainReference": "PREMIER_ITEM_DE_TEST",
        "name": "MON ITEM DE TEST",
        "preTaxUnitPrice": "10.76",
        "quantity": "1",
        "storeReference": "12",
        "AccountAdvantageRequest": [
          {
            "type": "1",
            "value": "10"
          }
        ],
        "universReference": "345"
      },
      {
        "allTaxesIncludedUnitPrice": "24.99",
        "discountAmount": "0",
        "ean": "222222",
        "mainReference": "DEUXIEME_ITEM_DE_TEST",
        "name": "UN AUTRE ITEM DE TEST",
        "preTaxUnitPrice": "21.47",
        "quantity": "1"
      }
    ]
  },
  "ReceiptRequest": {
    "allTaxesIncludedAmount": "37.56",
    "cashdeskIpAddress": "127.0.0.1",
    "cashdeskNumber": "2",
    "currency": "1",
    "discountAmount": "2",
    "EntityRequest": {
      "entityIdentifier": "666666"
    },
    "IdentifierRequest": {
      "identifierType": "1",
      "identifierValue": "1234567891011"
    },
    "preTaxAmount": "34.58",
    "receiptNumber": "MON-TICKET-270925-1",
    "AccountAdvantageRequest": [
      {
        "type": "1",
        "value": "0"
      }
    ],
    "transactionDate": "27/09/2025 16:30:00"
  }
}'

Responses

🟢200Success

application/json

Body

Example

{
    "creationDate": 1759007624569,
    "transactionId": "A158",
    "responseCode": "000",
    "infos": "Request successfully processed\nserver.instance.name=API-DOG preprod serveur 1 instance 1\n"
}

Modified at 2025-09-30 09:35:43

cancelTransactionsNotValidated

refundTransaction