TecnoSpeed - Pagamentos

Nome da Integração ou customização:

Tecnospeed pagamentos via API (VAN)

Finalidade: 

Tem a finalidade de enviar pagamentos ao banco diretamente pelo Movtrans sem a necessidade de enviar arquivo remessa e retorno e também quando efetivado o pagamento que o  lançamento compense automaticamente no Movtrans.

Funciona com pagamentos de TED, DOC e BOLETOS .
Não está implementado ainda: PIX (em breve) , GARE, IPVA, DPVAT, DARF sem código de barras, FGTS, GPS.

Bancos homologados:
Banco do Nordeste - Caixa Econômica - Banco do Brasil - Citibank - Bradesco*** - Santander - Itaú*** - Sicredi*** - Sicoob - Safra* - Banrisul - BMG** - Unicred

(*) Não aceita pagamento de TED e DOC

(**) Não aceita Pagamento de Boletos

(***)Aceitam PIX para Pagamento por chave


Funcionamento: 

Assim que quitado a conta a pagar, o pagamento é enviado ao banco para efetivação. No sistema, a conta a pagar fica como paga em "Cheque" e status "Não compensado". (Similar ao funcionamento do cheque).  O lançamento só será compensada quando, via webhook o banco sinalizar que foi efetivado o pagamento. 

De forma simplificada podemos sintetizar o processo de envio e recepção de remessas da seguinte forma:

Passo 1: O pagamento é quitado no Movtrans, e enviamos via API o Pagamento e a remessa, a mesma é enviada ao banco via VAN Nexxera;

Passo 2: A Remessa é processada pelo banco e gera um retorno;

Passo 3: A tecnospeed retorna via API o Webhook abaixo: 

PAID:
{
"status": "PAID",
"uniqueId": "xxxxxx", ---> Essa ID vai estar dentro do Contas a Pagar
"authenticationRegister":"xxxxxxxxxxxx",
"createdAt": "2020-08-27T17:04:58.796Z",
"paymentDate": "2020-08-27",---> Data do pagamento
"occurrences": [{
"code":"00",
"message": "PAGAMENTO EFETUADO",
"createdAt":"2020-08-28T18:13:58.824Z",
"occurrenceDate": "2020-08-28T18:13:58.817Z"
}],
"accountHash":"xxxxxxxxx"
},
"headers": {
"login": "exemplo",
"token": "exemplo"
}

O processo de envio e recebimento de remessas é algo bem simples, contudo, por conta da particularidade de cada banco o tempo de envio e recebimento para os arquivos variam de banco para banco.

Para os principais bancos elaboramos um descritivo, mostrando qual o tempo de envio de remessas e recebimento de retornos para o serviço de Pagamentos:

Envio: Pagamentos enviados até 17:59 autorizados

Retorno: 2 horas para o processamento.

Envio: Pagamentos enviados até 17h, após este horário será bloqueado.

Retorno: 2 horas para o processamento.

Envio: Pagamentos enviados até às 17h podem ser autorizados. Após às 17h será bloqueado. Pagamentos a receber até às 20hrs.

Retorno: Próximo dia útil

Envio: Pagamentos enviados até 17:59 autorizados

Retorno: Próximo dia útil


Requisitos:


Configuração

Após a conta homologada, vá no cadastro da conta corrente a ser integrada, e marque "Usa Integração". Após isso quando quitar a conta ela será enviada ao Banco


Fluxo de uso:

Conta a pagar criada > Quitação da Conta> Pagamento fica como aguardando efetivação no Banco.


Informações enviadas: Campo - Origem - Vínculo (TabelaPrimária->Modulo->Local) - (Obrigatório/Opcional)


"payerCpfCnpj": CNPJ - Clifor/Contaspa/Empresa- Obrigatório

"accountHash": Id da Conta - Conta Bancária - Obrigatório

"description"  - Nº Documento - Contas a Pagar - Obrigatório
"paymentForm" - Tipo Doc. - Tipo de Documento - Obrigatório
"paymentDate" - Data Quitação- Quitação - Obrigatório
"paymentForm" - Tipo Doc. - Tipo de Documento - Obrigatório
"nominalAmount" - Valor a pagar - Contas a Pagar - Obrigatório
"amount" - Valor a pagar. - Contas a Pagar - Obrigatório
"barcode" - Codigo de Barras - Contas a Pagar - Obrigatório

"beneficiary": 

{

"name": Nome do Fornecedor - Clifor/Contaspa/Fornecedor - Obrigatório

"cpfCnpj": CNPJ - Clifor/Contaspa/Fornecedor - Obrigatório
"bankCode": Codigo do Banco - Bancos/Clifor- Obrigatório

"agency": Número da Agência Bancária - Conta Bancária - Obrigatório

"agencyDigit": Digito da Agência da Conta Bancária - Conta Bancária - Opcional (Absorverá o que estiver após o - informado no código da agencia)

"accountNumber": Número da Conta Bancária - Conta Bancária - Obrigatório

"accountNumberDigit": Dígito da Conta Bancária - Conta Bancária - Obrigatório (Absorverá o que estiver após o - informado no número da Conta)

"street": Rua - Clifor/Contaspa/Fornecedor- Obrigatório 

"neighborhood": Bairro - Clifor/Contaspa/Fornecedor- Obrigatório 

"addressNumber": Número - Clifor/Contaspa/Fornecedor- Obrigatório 

"addressComplement": Complemento - Clifor/Contaspa/Fornecedor- Obrigatório 

"City": Cidade - Clifor/Contaspa/Fornecedor- Obrigatório
"state": Estado - Clifor/Contaspa/Fornecedor- Obrigatório
 "zipcode": CEP - Clifor/Contaspa/Fornecedor- Obrigatório
 }

"rebateAmount": ? - Clifor/Contas a Pagar- Obrigatório 

"interestAmount": ? - Clifor/Contas a Pagar- Obrigatório 

"discountAmount": ? - Clifor/Contas a Pagar- Obrigatório
 "fineAmount": ? - Clifor/Contas a Pagar- Obrigatório 

"dueDate": Data do Vencimento - Contas a pagar - Obrigatório

"tag": Codigo - Contas a pagar - Opcional





Principais Rejeições: Erro - Resolutiva:



Log de envios para Tecnospeed:

Link do Log de remesa:
https://tecnospeed.movtrans.host/tecnospeed/api/logs/remittance.json

Utilidade:


Log de Pagamento Boleto: 

https://tecnospeed.movtrans.host/tecnospeed/api/logs/paymentBoletos.json

Utilidade:

Log de Pagamento TED: 

https://tecnospeed.movtrans.host/tecnospeed/api/logs/paymentTransfer.json
Utilidade:


Webhook: 

https://tecnospeed.movtrans.host/tecnospeed/api/logs/webhook.json
Utilidade: