Informações gerais
Remessa é quando o dinheiro é transferido de uma parte para outra. Um exemplo pode ser quando dinheiro é enviado do banco do integrador de pagamentos para o banco do Google. O diagrama a seguir ilustra como isso ocorre.
Como o fluxo funciona
O diagrama a seguir ilustra um exemplo de como o fluxo de remessa pode funcionar.
Integrador de pagamento de remessa para o Google
Veja uma lista dos objetos usados no diagrama:
- Servidor do Google: o servidor de back-end no Google que faz a verificação de autenticação, além de outras tarefas.
- Integrador de pagamentos: a empresa que oferece uma forma de pagamento aos clientes.
- Banco do integrador de pagamentos: o banco emissor usado pelo integrador para transações financeiras.
- Google Bank: o banco que o Google usa em transações.
O fluxo de remessa acima começa com o servidor do Google.
- Nos dias T+N, o Google envia a notificação do extrato de remessa (
remittanceStatementNotification
). - O integrador de pagamentos notifica o servidor do Google de que recebeu a notificação do extrato de remessa.
- O integrador de pagamentos também envia detalhes do extrato de remessa (
remittanceStatementDetails
). - O servidor do Google responde com a instrução com o transactionDetails.
- O integrador de pagamentos reconcilia os detalhes.
- O integrador de pagamentos envia uma mensagem (
acceptRemittanceStatement
) ao servidor do Google informando que a fatura foi aceita. - O integrador de pagamentos também envia uma mensagem informando que o banco do integrador de pagamentos deve enviar fundos ao banco do Google.
- O banco do integrador de pagamentos transfere fundos para o Google Bank.
Práticas recomendadas e outras considerações
Cronograma
As condições de pagamento são definidas no contrato e normalmente expressas como T+N. T é a frequência com que um extrato de remessa é gerado e a duração do período que cada extrato abrange. No exemplo a seguir, T é um dia de transação. N é o número de dias após o período de transação que o extrato de remessa chega.
Se N estiver configurado como 2 e uma transação for contabilizada às 23:59:59.999 no fuso horário do faturamento na terça-feira, ela aparecerá em um extrato na quinta-feira.
Declarações negativas ou de zero
Nos dias em que não houver transações dentro do período de faturamento, as notificações de extrato de remessa não serão enviadas. Além disso, se houver reembolsos dentro de um período de faturamento que resulte em um valor líquido negativo da fatura, os extratos de remessa também não serão enviados. No entanto, essas transações serão incluídas na próxima fatura líquida positiva, para a qual a notificação do extrato de remessa será enviada. Caso o valor da transação seja 0 em um período de faturamento específico, serão enviadas notificações de extrato de remessa.
Limites
Veja abaixo alguns exemplos com vários limites. Um limite transacional é quando a transação começa ou é confirmada. O carimbo de data/hora da contabilidade é quando o Google registrou essa transação. Um limite de declaração de remessa começa às 00:00:00.000 e termina às 23:59:59.000.
Transação dentro dos limites
Evento | |
---|---|
Capturar | requestHeader.requestId
001 requestHeader.requestTimestamp 01/01/2017 23:26:32.253 responseHeader.responseTimestamp 01/01/2017 23:26:34.248 accounting/20121/201.26 |
RemittanceStatementNotification | requestHeader.requestTimestamp
01/03/2017 03:17:18.132 billingPeriod.startDate 01/01/2017 00:00:00.000 billingPeriod.endDate Esta notificação 01/01/2019 23:59. |
ultrapassar os limites da transação
Uma das capturas abaixo tem todos os carimbos de data/hora de 01/01/2017, mas não é contabilizado até 02/01/2017.
Evento | |
---|---|
Capturar | requestHeader.requestId
001 requestHeader.requestTimestamp 01/01/2017 23:26:32.253 responseHeader.responseTimestamp 01/01/2017 23:26:34.248 accounting/20121/201.26 |
Capturar | requestHeader.requestId
002 requestHeader.requestTimestamp 01/01/2017 23:59:58.253 responseHeader.responseTimestamp 01/01/2017 23:59:59.800 accounting202020 01.0/carimbo de data/hora da conta |
RemittanceStatementNotification | requestHeader.requestTimestamp
01/03/2017 03:17:18.132 billingPeriod.startDate 01/01/2017 00:00:00.000 billingPeriod.endDate Esta notificação 01/01/2019 mitance 23:59 inclui apenas a notificação 23:59. |
RemittanceStatementNotification | requestHeader.requestTimestamp
01/03/2017 00:27:34.321 billingPeriod.startDate 01/02/2017 00:00:00.000 billingPeriod.endDate Essa notificação inclui 01/02/2019 23.59. Como 002 foi contabilizado em 02/01/2017, não em 01/01/2017. |
Reconciliação.
Pode haver casos em que o Google envie uma declaração de remessa mais tarde do que o esperado. Por exemplo, se o Google encontrar um bug que atrasa a notificação do extrato de remessa em um dia.
Se houver transações retornadas pelo método remittanceStatementDetails
que o integrador não tiver dentro do período de faturamento, ele precisará notificar o Google sobre a discrepância imediatamente. Outra possibilidade seria se houver transações que o integrador espera, mas não sejam retornadas. Assim que a discrepância for resolvida, o Google poderá enviar uma nova fatura com um novo ID.
Aceitação da declaração de remessa
O integrador vai aceitar uma instrução quando ele chamar o método acceptRemittanceStatement
.
Os extratos devem ser pagos dentro dos termos NET definidos no contrato após a aceitação. As disputas devem ser tratadas manualmente entre o integrador e o gerente de contas.
Pagamento
Os extratos de remessa fornecem os detalhes necessários sobre o valor a ser pago. Cada extrato deve ser pago integralmente. Se houver uma disparidade, o integrador precisará entrar em contato com o gerente de contas para lidar com a disputa. Esses casos podem resultar no não pagamento de uma fatura integral.
Precisão
Cada taxa será calculada com a precisão definida como o número de unidades secundárias especificado no padrão ISO 4217 para essa moeda. Por exemplo, INR e USD usará unidades secundárias de 2 dígitos e JPY usará unidades secundárias de 0 dígitos.
Se forem necessárias mais casas decimais para representar a taxa, o Google arredondará para a unidade menor mais próxima. Os empates serão arredondados para a menor unidade mais próxima. Por exemplo, usando as unidades secundárias de 2 dígitos da INR:
Taxa calculada | Taxa arredondada |
---|---|
0.013 | 0,01 |
0,015 | 0,02 |
0,025 | 0,02 |
-0.013 | -0,01 |
-0,025 | -0,02 |
Esse arredondamento vai acontecer em todas as transações, não de maneira agregada no extrato.