Pular para o conteúdo principal

Exemplo de Arquivo - Remessa de Vendas

Este documento mostra exemplos reais e atualizados de registros retornados em uma remessa de Vendas, cobrindo diferentes meios de pagamento.


Exemplo 1: Venda em Aberto (A1) - Crédito à Vista

Venda no crédito à vista que aparece no extrato da adquirente, mas não foi encontrada no ERP.

Payload Real da API

{
"PRODUTO": "Crédito à Vista",
"CARTAO": "406669******1234",
"VLLIQUIDO": 374.03,
"NRPEDIDO": null,
"IDADQUIRENTE": 2,
"VLCOMISSAO": 6.47,
"AUTORIZACAO": 652123,
"ESTABELECIMENTO": "LOJA TESTE",
"IDMOVIMENTO": "A1",
"ESTABELECIMENTOERP": "LOJA TESTE - MATRIZ",
"LOTE": 35932195,
"PARCELA": 1,
"DTVENCIMENTO": 20260430,
"CONTA": null,
"VLBRUTO": 380.5,
"BANCO": null,
"FILIACAO": 37044123,
"IDMOVFINAN": 2000000021251234,
"DTMOVIMENTO": 20260330,
"LOTEUNICO": 2608963221234,
"AGENCIA": null,
"MOVIMENTO": "Venda em Aberto",
"NSR": 91,
"TID": null,
"NSU": 335651234,
"ADQUIRENTE": "Rede",
"BANDEIRA": "Visa",
"DTVENDA": 20260330,
"HRVENDA": 91525,
"IDBANDEIRA": 1,
"PRODUTOTIPO": 1,
"NRTERMINAL": "PV195123",
"TOTALPARCELAS": 1,
"FLSITUACAO": "L",
"CNPJ": "31539773000174",
"NMFANTASIA": "LOJA TESTE",
"NRSEQUENCIA": 1,
"NMPRODUTO": "Crédito à Vista",
"NMTERMINALTIPO": "POS",
"IDTERMINALTIPO": 1
}

Interpretação

CampoValorSignificado
PRODUTO"Crédito à Vista"Crédito em 1x
CARTAO"406669******1234"Cartão Visa mascarado
VLBRUTO380.50Valor total da venda
VLCOMISSAO6.47Taxa da adquirente (~1.7%)
VLLIQUIDO374.03Valor a receber
DTVENCIMENTO2026043030 dias após a venda
TOTALPARCELAS1Pagamento único
HRVENDA09152509:15:25

Exemplo 2: Venda em Aberto (A1) - Crédito Parcelado (Loja)

Venda parcelada em 4x no crédito.

Payload Real da API

{
"PRODUTO": "Parcelado Loja",
"CARTAO": "515527******1234",
"VLLIQUIDO": 174.98,
"NRPEDIDO": null,
"IDADQUIRENTE": 2,
"VLCOMISSAO": 3.59,
"AUTORIZACAO": 376321,
"ESTABELECIMENTO": "LOJA TESTE",
"IDMOVIMENTO": "A1",
"ESTABELECIMENTOERP": "LOJA TESTE - MATRIZ",
"LOTE": 48349123,
"PARCELA": 3,
"DTVENCIMENTO": 20260630,
"CONTA": null,
"VLBRUTO": 178.57,
"BANCO": null,
"FILIACAO": 102400123,
"IDMOVFINAN": 2000000021259876,
"DTMOVIMENTO": 20260330,
"LOTEUNICO": 260891822441234,
"AGENCIA": null,
"MOVIMENTO": "Venda em Aberto",
"NSR": 105,
"TID": null,
"NSU": 335819876,
"ADQUIRENTE": "Rede",
"BANDEIRA": "MasterCard",
"DTVENDA": 20260330,
"HRVENDA": 84449,
"IDBANDEIRA": 2,
"PRODUTOTIPO": 3,
"NRTERMINAL": "AB194123",
"TOTALPARCELAS": 4,
"FLSITUACAO": "P",
"CNPJ": "31539773000174",
"NMFANTASIA": "LOJA TESTE",
"NRSEQUENCIA": 3,
"NMPRODUTO": "Parcelado Loja",
"NMTERMINALTIPO": "POS",
"IDTERMINALTIPO": 1
}

Interpretação

CampoValorSignificado
PRODUTO"Parcelado Loja"Crédito parcelado
CARTAO"515527******1234"Cartão MasterCard mascarado
TOTALPARCELAS4Total de 4 parcelas
VLBRUTO178.57Valor total da parcela (1/4 do total)
DTVENCIMENTO20260630Vencimento em 30/06/2026
VDA_STATUS1Acatada (aprovada)
HRVENDA08444908:44:49
Venda parcelada em 4x no crédito, onde cada parcela é retornada como um registro individual dentro do array de registros.

Exemplo Completo: Venda Parcelada em 4x (A1)

{
"registros": {
"registro": [
{
"PRODUTO": "Parcelado Loja",
"CARTAO": "515527******1234",
"VLLIQUIDO": 174.98,
"NRPEDIDO": null,
"IDADQUIRENTE": 2,
"VLCOMISSAO": 3.59,
"AUTORIZACAO": 376321,
"ESTABELECIMENTO": "LOJA TESTE",
"IDMOVIMENTO": "A1",
"ESTABELECIMENTOERP": "LOJA TESTE - MATRIZ",
"LOTE": 48349123,
"PARCELA": 1,
"DTVENCIMENTO": 20260430,
"CONTA": null,
"VLBRUTO": 178.57,
"BANCO": null,
"FILIACAO": 102400123,
"IDMOVFINAN": 2000000021259876,
"DTMOVIMENTO": 20260330,
"LOTEUNICO": 260891822441234,
"AGENCIA": null,
"MOVIMENTO": "Venda em Aberto",
"NSR": 105,
"TID": null,
"NSU": 335819876,
"ADQUIRENTE": "Rede",
"BANDEIRA": "MasterCard",
"DTVENDA": 20260330,
"HRVENDA": 144834,
"IDBANDEIRA": 2,
"PRODUTOTIPO": 3,
"NRTERMINAL": "AB194123",
"TOTALPARCELAS": 4,
"FLSITUACAO": "P",
"CNPJ": "31539773000174",
"NMFANTASIA": "LOJA TESTE",
"NRSEQUENCIA": 1,
"NMPRODUTO": "Parcelado Loja",
"NMTERMINALTIPO": "POS",
"IDTERMINALTIPO": 1
},
{
"PRODUTO": "Parcelado Loja",
"CARTAO": "515527******1234",
"VLLIQUIDO": 174.98,
"NRPEDIDO": null,
"IDADQUIRENTE": 2,
"VLCOMISSAO": 3.59,
"AUTORIZACAO": 376321,
"ESTABELECIMENTO": "LOJA TESTE",
"IDMOVIMENTO": "A1",
"ESTABELECIMENTOERP": "LOJA TESTE - MATRIZ",
"LOTE": 48349123,
"PARCELA": 2,
"DTVENCIMENTO": 20260530,
"CONTA": null,
"VLBRUTO": 178.57,
"BANCO": null,
"FILIACAO": 102400123,
"IDMOVFINAN": 2000000021259876,
"DTMOVIMENTO": 20260330,
"LOTEUNICO": 260891822441234,
"AGENCIA": null,
"MOVIMENTO": "Venda em Aberto",
"NSR": 106,
"TID": null,
"NSU": 335819876,
"ADQUIRENTE": "Rede",
"BANDEIRA": "MasterCard",
"DTVENDA": 20260330,
"HRVENDA": 144834,
"IDBANDEIRA": 2,
"PRODUTOTIPO": 3,
"NRTERMINAL": "AB194123",
"TOTALPARCELAS": 4,
"FLSITUACAO": "P",
"CNPJ": "31539773000174",
"NMFANTASIA": "LOJA TESTE",
"NRSEQUENCIA": 2,
"NMPRODUTO": "Parcelado Loja",
"NMTERMINALTIPO": "POS",
"IDTERMINALTIPO": 1
},
{
"PRODUTO": "Parcelado Loja",
"CARTAO": "515527******1234",
"VLLIQUIDO": 174.98,
"NRPEDIDO": null,
"IDADQUIRENTE": 2,
"VLCOMISSAO": 3.59,
"AUTORIZACAO": 376321,
"ESTABELECIMENTO": "LOJA TESTE",
"IDMOVIMENTO": "A1",
"ESTABELECIMENTOERP": "LOJA TESTE - MATRIZ",
"LOTE": 48349123,
"PARCELA": 3,
"DTVENCIMENTO": 20260630,
"CONTA": null,
"VLBRUTO": 178.57,
"BANCO": null,
"FILIACAO": 102400123,
"IDMOVFINAN": 2000000021259876,
"DTMOVIMENTO": 20260330,
"LOTEUNICO": 260891822441234,
"AGENCIA": null,
"MOVIMENTO": "Venda em Aberto",
"NSR": 107,
"TID": null,
"NSU": 335819876,
"ADQUIRENTE": "Rede",
"BANDEIRA": "MasterCard",
"DTVENDA": 20260330,
"HRVENDA": 144834,
"IDBANDEIRA": 2,
"PRODUTOTIPO": 3,
"NRTERMINAL": "AB194123",
"TOTALPARCELAS": 4,
"FLSITUACAO": "P",
"CNPJ": "31539773000174",
"NMFANTASIA": "LOJA TESTE",
"NRSEQUENCIA": 3,
"NMPRODUTO": "Parcelado Loja",
"NMTERMINALTIPO": "POS",
"IDTERMINALTIPO": 1
},
{
"PRODUTO": "Parcelado Loja",
"CARTAO": "515527******1234",
"VLLIQUIDO": 174.98,
"NRPEDIDO": null,
"IDADQUIRENTE": 2,
"VLCOMISSAO": 3.59,
"AUTORIZACAO": 376321,
"ESTABELECIMENTO": "LOJA TESTE",
"IDMOVIMENTO": "A1",
"ESTABELECIMENTOERP": "LOJA TESTE - MATRIZ",
"LOTE": 48349123,
"PARCELA": 4,
"DTVENCIMENTO": 20260730,
"CONTA": null,
"VLBRUTO": 178.57,
"BANCO": null,
"FILIACAO": 102400123,
"IDMOVFINAN": 2000000021259876,
"DTMOVIMENTO": 20260330,
"LOTEUNICO": 260891822441234,
"AGENCIA": null,
"MOVIMENTO": "Venda em Aberto",
"NSR": 108,
"TID": null,
"NSU": 335819876,
"ADQUIRENTE": "Rede",
"BANDEIRA": "MasterCard",
"DTVENDA": 20260330,
"HRVENDA": 144834,
"IDBANDEIRA": 2,
"PRODUTOTIPO": 3,
"NRTERMINAL": "AB194123",
"TOTALPARCELAS": 4,
"FLSITUACAO": "P",
"CNPJ": "31539773000174",
"NMFANTASIA": "LOJA TESTE",
"NRSEQUENCIA": 4,
"NMPRODUTO": "Parcelado Loja",
"NMTERMINALTIPO": "POS",
"IDTERMINALTIPO": 1
}
]
}
}

Análise das 4 Parcelas

ParcelaPARCELADTVENCIMENTONSRVLBRUTOVLLIQUIDO
130/04/2026105178,57174,98
230/05/2026106178,57174,98
330/06/2026107178,57174,98
430/07/2026108178,57174,98

Totais da Venda:

  • Valor Bruto Total: 4 × R$ 178,57 = R$ 714,28
  • Taxa Total: 4 × R$ 3,59 = R$ 14,36
  • Valor Líquido Total: 4 × R$ 174,98 = R$ 699,92

Observações sobre o Agrupamento

Para agrupar as parcelas de uma mesma venda, utilize o campo LOTEUNICO. Ele é a chave mestre que vincula todos os registros de uma mesma transação.

function agruparParcelas(registros) {
const vendas = {};
registros.forEach(reg => {
const chave = reg.LOTEUNICO;
if (!vendas[chave]) {
vendas[chave] = {
loteUnico: chave,
cartao: reg.CARTAO,
dataVenda: reg.DTVENDA,
totalParcelas: reg.PARCELAS,
valorTotalBruto: 0,
parcelas: []
};
}
vendas[chave].parcelas.push(reg);
vendas[chave].valorTotalBruto += reg.VLBRUTO;
});
return Object.values(vendas);
}

Exemplo 3: Venda em Aberto (A1) - Boleto Bancário

Venda via boleto que foi liquidada, mas não conciliada com o ERP.

Payload Real da API

{
"PRODUTO": "Boleto Bancário",
"CARTAO": null,
"VLLIQUIDO": 497.20,
"NRPEDIDO": "PED-998877",
"IDADQUIRENTE": 15,
"VLCOMISSAO": 2.80,
"AUTORIZACAO": 998877,
"ESTABELECIMENTO": "LOJA TESTE",
"IDMOVIMENTO": "A1",
"ESTABELECIMENTOERP": "LOJA TESTE - MATRIZ",
"LOTE": 123456,
"PARCELA": 1,
"DTVENCIMENTO": 20260401,
"CONTA": null,
"VLBRUTO": 500.00,
"BANCO": null,
"FILIACAO": 99887766,
"IDMOVFINAN": 3000000012345678,
"DTMOVIMENTO": 20260330,
"LOTEUNICO": 9988776655443322,
"AGENCIA": null,
"MOVIMENTO": "Venda em Aberto",
"NSR": 501,
"TID": "BOL-332211",
"NSU": 998877,
"ADQUIRENTE": "Bradesco",
"BANDEIRA": "Outras",
"DTVENDA": 20260328,
"HRVENDA": 82102,
"IDBANDEIRA": 99,
"PRODUTOTIPO": 13,
"NRTERMINAL": "BOL001",
"TOTALPARCELAS": 1,
"FLSITUACAO": "L",
"CNPJ": "31539773000174",
"NMFANTASIA": "LOJA TESTE",
"NRSEQUENCIA": 1,
"NMPRODUTO": "Boleto Bancário",
"NMTERMINALTIPO": "BOLETO",
"IDTERMINALTIPO": 3
}

Exemplo 4: Venda em Aberto (A1) - Débito à Vista

Venda no cartão de débito.

Payload Real da API

{
"PRODUTO": "Débito à Vista",
"CARTAO": "406669******4321",
"VLLIQUIDO": 99.20,
"NRPEDIDO": null,
"IDADQUIRENTE": 2,
"VLCOMISSAO": 0.80,
"AUTORIZACAO": 123456,
"ESTABELECIMENTO": "LOJA TESTE",
"IDMOVIMENTO": "A1",
"ESTABELECIMENTOERP": "LOJA TESTE - MATRIZ",
"LOTE": 35932196,
"PARCELA": 1,
"DTVENCIMENTO": 20260331,
"CONTA": null,
"VLBRUTO": 100.00,
"BANCO": null,
"FILIACAO": 102400123,
"IDMOVFINAN": 2000000021259999,
"DTMOVIMENTO": 20260330,
"LOTEUNICO": 260891822449999,
"AGENCIA": null,
"MOVIMENTO": "Venda em Aberto",
"NSR": 202,
"TID": null,
"NSU": 445566,
"ADQUIRENTE": "Rede",
"BANDEIRA": "Visa",
"DTVENDA": 20260330,
"HRVENDA": 94454,
"IDBANDEIRA": 1,
"PRODUTOTIPO": 2,
"NRTERMINAL": "PV195123",
"TOTALPARCELAS": 1,
"FLSITUACAO": "L",
"CNPJ": "31539773000174",
"NMFANTASIA": "LOJA TESTE",
"NRSEQUENCIA": 1,
"NMPRODUTO": "Débito à Vista",
"NMTERMINALTIPO": "POS",
"IDTERMINALTIPO": 1
}

Exemplo 5: Venda em Aberto (A1) - Pix (Cielo)

Venda via Pix processada por uma adquirente (Cielo).

Payload Real da API

{
"PRODUTO": "Pagto Instantâneo",
"CARTAO": null,
"VLLIQUIDO": 5744.25,
"NRPEDIDO": null,
"IDADQUIRENTE": 1,
"VLCOMISSAO": 24.75,
"AUTORIZACAO": 654321,
"ESTABELECIMENTO": "LOJA TESTE",
"IDMOVIMENTO": "A1",
"ESTABELECIMENTOERP": "LOJA TESTE - MATRIZ",
"LOTE": 48349000,
"PARCELA": 1,
"DTVENCIMENTO": 20260330,
"CONTA": null,
"VLBRUTO": 5769.00,
"BANCO": null,
"FILIACAO": 102400000,
"IDMOVFINAN": 1000000021250000,
"DTMOVIMENTO": 20260330,
"LOTEUNICO": 260891822440000,
"AGENCIA": null,
"MOVIMENTO": "Venda em Aberto",
"NSR": 303,
"TID": "PX123456789",
"NSU": 778899,
"ADQUIRENTE": "Cielo",
"BANDEIRA": "Pix",
"DTVENDA": 20260330,
"HRVENDA": 152448,
"IDBANDEIRA": 135,
"PRODUTOTIPO": 103,
"NRTERMINAL": "CZ123456",
"TOTALPARCELAS": 1,
"FLSITUACAO": "P",
"CNPJ": "31539773000174",
"NMFANTASIA": "LOJA TESTE",
"NRSEQUENCIA": 1,
"NMPRODUTO": "Pagto Instantâneo",
"NMTERMINALTIPO": "Pix",
"IDTERMINALTIPO": 2
}

Tabela Comparativa: Meios de Pagamento

Meio de PagamentoIDPRODUTOPRODUTOBANDEIRADTVENCIMENTOVLCOMISSAO Típica
Pix103"Pagto Instantâneo""Pix" (135)D+0~0.4%
Débito2"Débito à Vista"Visa/MasterD+1~0.6-0.8%
Crédito à Vista1"Crédito à Vista"Visa/MasterD+30~1.7-2.5%
Crédito Parcelado3"Parcelado Loja"Visa/Master30-180 dias~2-4%
Boleto13"Boleto Bancário""Outras" (99)D+2R$ 2,80 fixo

Observações Importantes

Formato das Datas e Horas

CampoFormatoExemplosObservação
DTMOVIMENTONúmero YYYYMMDD20260330Data do registro
DTVENDANúmero YYYYMMDD20260330Data da transação
DTVENCIMENTONúmero YYYYMMDD20260430Data prevista do depósito
HRVENDANúmero HHMMSS100629Número, não string

Confirmado: HRVENDA é sempre um número (sem aspas). Ex: 100629.

Sobre o Movimento A1 (Venda em Aberto)

O movimento A1 indica que a Equals encontrou esta transação no extrato da adquirente, mas não localizou um registro correspondente no arquivo de vendas enviado pelo seu ERP.

Possíveis causas:

  • O ERP não enviou o arquivo de vendas do período
  • O arquivo foi enviado, mas esta venda específica não estava nele
  • Houve erro no processamento do arquivo de vendas

Possíveis ações (a critério do seu negócio):

  • Registrar esta venda manualmente no Contas a Receber
  • Investigar por que o ERP não enviou esta transação
  • Reenviar o arquivo de vendas com esta transação
  • Ignorar (se for um caso pontual já tratado)

Nota: A Equals Connect apenas reporta os dados. A decisão de como tratar vendas em aberto é do seu processo de conciliação.

Parcelamento

Para vendas parceladas:

  • Cada parcela gera um registro A1 separado
  • O campo PARCELA indica qual parcela é aquela (1, 2, 3...)
  • O campo PARCELAS indica o total de parcelas
  • Cada parcela tem seu próprio DTVENCIMENTO
  • Os valores (VLBRUTO, VLLIQUIDO) são por parcela, não o total da venda

Este conteúdo foi útil para você?