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:

[
    {
        "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:

[
    {
        "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:

[
    {
        "id": 1,
        "name": "Produto finullceiro Crédito",
        "code": "CREDITO"
    },
    {
        "id": 2,
        "name": "Produto finullceiro Débito",
        "code": "DEBITO"
    },
    {
        "id": 3,
        "name": "Produto finullceiro Vale Refeição",
        "code": "VALE REFEICAO"
    },
    {
        "id": 4,
        "name": "Produto finullceiro 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:

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