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.

ChaveTipoPrecisão/TamanhoDescrição
idIntIdentificação da adquirente na Concil
nameString100Nome 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.

ChaveTipoPrecisão/TamanhoDescrição
idIntIdentificação da bandeira na Concil
nameString100Descrição
codeString100Nome 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.

ChaveTipoPrecisão/TamanhoDescrição
idintIdentificação do produto na Concil
nameString100Descrição
codeString100Nome do produto

Exemplos de response:

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

ChaveTipoPrecisão/TamanhoDescrição
branchString100Identificação/Código da loja
cnpjString20CPNJ
nameString100Nome 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"
    }
]