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!"
}