Query by transaction
This functionality is intended to return transaction data from its key.
The key consists of the fields:
- CodSit
- transaction date
- NSU SiTef
- Cstore code SiTef
- Customer code (only on the platform SiTef GW/Express)
This key must be sent as a parameter in the request URL(QueryString).
Optionally, you can enter the field (invoice) and, in this case, it is not necessary to include the NSU SiTef of the transaction. It should be noted, however, that as the field (invoice) is not a transaction search key, more of a transaction can be returned in that case.
Another option is to replace the SiTef Store Code filter with Sub-Acquirer Store Code (codlojatronco).
Call details#
Method:
GETURL:
URL basic + transactions/search?codsit=000&datatrn=aaaammdd&nsusitef=00000000&codlojasitef=00000000Resposta: List of Transactions (see List of Transactions)
Description of URL parameters:
| Field | Description | Type | Size | Format | Required |
|---|---|---|---|---|---|
| codsit | SiTef Network Code | Numeric | 1-4 | - | Yes |
| datatrn | Transaction date | Numeric | 8 | YYYYMMDD | Yes |
| nsusitef | Transaction NSU SiTef | Numeric | 6 | - | No* |
| codlojasitef | Transaction SiTef Store Code | Alphanumeric | 8 | - | No** |
| cupomfiscal | Invoice associated with the transaction | Text | 1-20 | - | Not* |
| codlojatronco | Csub-acquirer store code | Alphanumeric | 8 | - | No** |
| codigo_cliente | Customer code | Numeric | 1-19 | - | Yes*** |
* It is necessary to inform nsusitef or invoice
** It is necessary to inform codlojasitef or codlojatronco
*** customer_code is required when used on SiTef GW/Express platform. Not used on SiTef-Conciliation customers.