Consulta por transação
Esta funcionalidade tem por finalidade retornar os dados de uma transação a partir de sua chave.
A chave é composta pelos campos:
- CodSit
- Data da transação
- NSU SiTef
- Código de Loja SiTef
- Código Cliente (apenas na plataforma SiTef GW/Express)
Esta chave deverá ser enviada como parâmetro na URL de requisição (QueryString).
Opcionalmente, pode-se informar o campo Cupom Fiscal e, nesse caso, não é necessário incluir o NSU SiTef da transação. Deve-se observar, porém, que como o campo Cupom Fiscal não é chave de busca de transações, mais de uma transação pode ser devolvida nesse caso.
Outra opção é substituir o filtro Código de Loja SiTef por Código de Loja Sub-Adquirente (codlojatronco).
Detalhes da chamada#
- Método:
GET - URL:
URL básica + transacoes/busca?codsit=000&datatrn=aaaammdd&nsusitef=00000000&codlojasitef=00000000 - Resposta: Lista de Transações (vide Lista de Transações)
- Descrição dos parâmetros da URL:
| Campo | Descrição | Tipo | Tamanho | Formato | Obrigatório |
|---|---|---|---|---|---|
| codsit | Código de Rede do SiTef | Numérico | 1-4 | - | Sim |
| datatrn | Data da transação | Numérico | 8 | AAAAMMDD | Sim |
| nsusitef | NSU SiTef da transação | Numérico | 6 | - | Não* |
| codlojasitef | Código de loja SiTef da transação | Alfanumérico | 8 | - | Não** |
| cupomfiscal | Cupom Fiscal associado à transação | Texto | 1-20 | - | Não* |
| codlojatronco | Código de loja sub-adquirente | Alfanumérico | 8 | - | Não** |
| codigo_cliente | Código do cliente | Numérico | 1-19 | - | Sim*** |
* É necessário informar nsusitef ou cupomfiscal
** É necessário informar codlojasitef ou codlojatronco
*** É necessário codigo_cliente quando utilizado em plataforma SiTef GW/Express. Não utilizado em clientes SiTef-Conciliação.