Validando lote de vendas

Ao receber o payload, validamos as colunas abaixo, pois esses dados estão relacionados com os critérios de conciliação e não devem ser informados fora do padrão especificado. As informações de acquirerId, brandId, branch e productId podem ser obtidas nas seções anteriores, detalhadas em Validando base de cadastro. O recurso para importação de vendas está disponível na seção Requisição de envio de vendas.

As vendas devem ser sempre enviadas abertas por parcelas.

❗️

NSU e autorização

Deixar de informar dados como nsu ou authorization impacta diretamente no resultado final da conciliação, pois são critérios chaves no processo de conciliação. É essencial que você informe os dados corretamente para uma conciliação eficiente e sem pendências.

🚧

Transações PIX

Para transações PIX em 26/01/2022 adicionamos algumas exceções nas validações sendo possível envia-las sem a identificação de códigos de branch e merchant, porque esses lançamentos são importados no lado da adquirente a partir do extrato bancário do cliente que também não possuem essas informações

Mais informações e exemplos em Importação de transações PIX.

Chave	Obrigatório	Tipo	Exemplo	Precisão/tamanho
id	Sim	string	"12358" - Esse campo é o ID da venda do cliente e chave obrigatória. Cada parcela deve possuir uma chave única	255
pfj	Sim	string	"999.1.1" - Esse campo é validado em nossa base de cadastros relacionados ao PFJ e APIKEY informados no header	30
acquirerId	Sim	int	"1" - Esse campo é validado em nossa base de adquirentes homologadas
brandId	Sim	int	"1" - Esse campo é validado em nossa base de bandeiras homologadas
branch	Sim	string	"1" - Esse campo é validado em nossa base de filiais cadastradas relacionadas ao PFJ e APIKEY informados no header	100
productId	Sim	int	"1" - Esse campo é validado em nossa base de produtos homologadas
tid	Não	string	"102930578TIDBHSGGT"	100
nsu	Sim	string	"48963" - NSU ou Autorização são obrigatórios, não podendo ser ambos nulos	30
authorization	Sim	string	"48963" - NSU ou Autorização são obrigatórios, não podendo ser ambos nulos	30
saleDate	Sim	string	"YYYYMMDD" 20200607 - Esse campo é a data da venda	8
invoice	Não	string	"123456" - Esse campo é a nota fiscal do cliente	255
merchant	Sim	string	"1056962078" - Esse campo é validado em nossa base de número de estabelecimentos cadastrados relacionados ao PFJ e APIKEY informados no header	30
cardNumber	Não	string	"123654****4242"	20
saleAmount	Sim	float	50.00 - Esse campo é o valor total da venda
installmentIndex	Sim	int	1 - Esse campo é o número da parcela. As vendas devem ser sempre abertas por parcela
installmentCount	Sim	int	1 - Esse campo é a quantidade total de parcelas. As vendas devem ser sempre abertas por parcela
installmentAmount	Sim	float	50.00 - Esse campo é o valor total da parcela
dueDate	Não	string	"YYYYMMDD" 20200707 - Esse campo é a data de vencimento da parcela	8

A lista completa dos tipos de transações pode ser consultada em https://concilcard.readme.io/reference#get_sale

Exemplos de JSON de vendas:

JSON

[
   {
      "saleAmount":1,
      "productId":1,
      "installmentAmount":1,
      "merchant":"01012021",
      "nsu":"",
      "saleDate":"20201210",
      "dueDate":"20201210",
      "branch":"CONCIL_SP",
      "installmentIndex":1,
      "pfj":"CONCIL.1.1",
      "installmentCount":1,
      "brandId":1,
      "id":1,
      "acquirerId":1
   },
   {
      "saleAmount":1,
      "productId":1,
      "installmentAmount":1,
      "merchant":"01012021",
      "nsu":"55",
      "saleDate":"20201210",
      "dueDate":"20201210",
      "branch":"CONCIL_SP",
      "installmentIndex":1,
      "pfj":"CONCIL.1.1",
      "installmentCount":1,
      "brandId":1,
      "id":2,
      "acquirerId":1
   }
]