Validando base de cadastro

Para cada importação de vendas realizamos validações para evitar inconsistências relacionadas à pendências de conciliações ou divergências de informações entre bases de cadastro do cliente e Concil. Os campos validados no payload são:

• acquirerId
• brandId
• branch
• productId
• nsu
• authorization
• saleDate
• merchant
• saleAmount
• installmentIndex
• installmentCount
• installmentAmount

Mais adiante especificaremos a descrição e validação de cada um dos campos e nesta seção tratamos apenas sobre acquirerId, brandId, productId, branch e merchant.

acquirerId

É a identificação da adquirente cadastrada na nossa base e o seu envio é obrigatório. Para salvar essa informação na sua base de cadastro, consulte o recurso Requisição de Adquirentes.

Chave	Tipo	Precisão/Tamanho	Descrição
id	Int		Identificação da adquirente na Concil
name	String	100	Nome da adquirente na Concil

🚧

Cadastros de bandeiras, adquirentes e produtos

Existem algumas dúvidas comuns quanto ao depara de informações de adquirente, bandeiras e produtos. É possível consultar a relação entre eles, além de quais adquirentes são atualmente homologadas na Concil através do link https://www.concil.com.br/adquirentes/.

Exemplos de response:

JSON

[
    {
        "id": 1,
        "name": "CIELO"
    }
    {
        "id": 17,
        "name": "STONE"
    },
    {
        "id": 18,
        "name": "BIN"
    },
    {
        "id": 19,
        "name": "DMCARD"
    },
    {
        "id": 2,
        "name": "REDECARD"
    }
]

Tabela de código das adquirentes: Acquirers

brandId

É a identificação da bandeira cadastrada na nossa base e o seu envio é obrigatório. Para salvar essa informação na sua base de cadastro, você deve consultar o recurso Requisição de Bandeiras.

Chave	Tipo	Precisão/Tamanho	Descrição
id	Int		Identificação da bandeira na Concil
name	String	100	Descrição
code	String	100	Nome da bandeira

Exemplos de response:

JSON

[
    {
        "id": 1,
        "name": "Visa",
        "code": "VISA"
    },
    {
        "id": 2,
        "name": "Mastercard",
        "code": "MASTERCARD"
    },
    {
        "id": 3,
        "name": "Amex",
        "code": "AMEX"
    },
    {
        "id": 56,
        "name": "Bandeira Vegascard",
        "code": "VEGASCARD"
    },
    {
        "id": 58,
        "name": "Bandeira Pix",
        "code": "PIX"
    },
    {
        "id": 59,
        "name": "Bandeira UnionPay",
        "code": "UNIONPAY"
    }
]

Tabela de código das bandeiras: Brands

productId

É a identificação do produto cadastrado na nossa base e o seu envio é obrigatório. Para salvar essa informação na sua base de cadastro, você deve consultar o recurso Requisição de Produtos.

Chave	Tipo	Precisão/Tamanho	Descrição
id	int		Identificação do produto na Concil
name	String	100	Descrição
code	String	100	Nome do produto

Exemplos de response:

JSON

[
    {
        "id": 1,
        "name": "Produto financeiro Crédito",
        "code": "CREDITO"
    },
    {
        "id": 2,
        "name": "Produto financeiro Débito",
        "code": "DEBITO"
    },
    {
        "id": 3,
        "name": "Produto financeiro Vale Refeição",
        "code": "VALE REFEICAO"
    },
    {
        "id": 4,
        "name": "Produto financeiro Vale Alimentação",
        "code": "VALE ALIMENTACAO"
    }
]

Tabela de código dos produtos: Products

branch

É o código/identificação das filiais cadastradas na nossa base e o seu envio é obrigatório. Para salvar essa informação na sua base de cadastro, você deve consultar o recurso Requisição de Branchs.

Chave	Tipo	Precisão/Tamanho	Descrição
branch	String	100	Identificação/Código da loja
cnpj	String	20	CPNJ
name	String	100	Nome da Loja

Exemplos de response:

JSON

[
    {
        "name": "LOJA X",
        "cnpj": "11.995.475/0001-11",
        "branch": "11995475000111"
    },
    {
        "name": "LOJA XI",
        "cnpj": "11.915.475/0001-23",
        "branch": "11915475000123"
    }
]