Vínculo de Cartão ao Portador
Método para vincular cartão ao proprietário ou motorista previamente cadastrado na plataforma EXTRATTA.
➢ Proprietário (Beneficiário) → Receber Frete
➢ Motorista → Receber Frete do Proprietário e/ou pegamento de diárias
Request
- ENDPOINT: Cartoes/VincularCartao
- VERBO: POST
| Índice | Chave | Descrição | Elem. | Tipo | Ocor. | Tam. | Versão |
|---|---|---|---|---|---|---|---|
| 1 | CNPJAplicacao | CNPJ para autenticação | E | Caractere | 1-1 | 14 | 1.0 |
| 2 | Token | Gerado a partir do CNPJ de autenticação para validar permissões de acesso | E | Caractere | 1-1 | 100 | 1.0 |
| 3 | DocumentoUsuarioAudit | Documento do usuário que está realizando a operação | E | Caractere | 1-1 | 14 | 1.0 |
| 4 | NomeUsuarioAudit | Nome do usuário que está realizando a operação | E | Caractere | 1-1 | 60 | 1.0 |
| 5 | CNPJEmpresa | CNPJ da empresa | E | Caractere | 1-1 | 14 | 1.0 |
| 6 | NumeroCartao * | Número do cartão a ser vinculado no portador. Este número está impresso no cartão entregue ao motorista. | E | Inteiro | 1-0 | 10 | 1.0 |
| 7 | Documento | CPF/CNPJ do proprietário, motorista ou usuário previamente cadastrado na plataforma EXTRATTA | E | Caractere | 1-1 | 14 | 1.0 |
* A Extratta possui ainda, um recurso de criação de um cartão virtual disponível SOMENTE PARA PROPRIETÁRIOS.
Neste caso, não tornar obrigatório o número do cartão quando for vincular ao proprietário.
REGRA: Quando integrado um contrato de frete (viagem) cujo pagamento é realizado em CARTÃO e o proprietário/beneficiário
da viagem não possui um cartão físico vinculado, a Extratta cria um cartão Virtual para o proprietário receber seu pagamento de Frete.
Modelo de Json - Request
{
"CNPJAplicacao": "",
"Token": "",
"DocumentoUsuarioAudit": "",
"NomeUsuarioAudit": "",
"CNPJEmpresa": "",
"NumeroCartao": 0,
"Documento": ""
}
Response
| Índice | Chave | Descrição | Elem. | Tipo | Ocor. | Tam. | Versão |
|---|---|---|---|---|---|---|---|
| 1 | Sucesso | Requisição realizada com sucesso ou não | E | Booleano | 1-1 | True/False | 1.0 |
| 2 | Mensagem | Mensagem de retorno | E | Caractere | 1-1 | 100 | 1.0 |
Modelo de Json - Response
{
"Sucesso": true,
"Mensagem": "Cartão vinculado com sucesso!"
}