Tratamento de erros (Importação de vendas)

Todas as requisições recusadas pelo serviço de importação com status code 400, são retornadas com o payload contendo o id de retorno das vendas, seguido dos códigos de erros.

ChaveTipoPrecisão/tamanho
idstring255Id da sua venda
messageCodes.id
messageCodes.acquirerId
messageCodes.brandId
messageCodes.productId
messageCodes.branch
messageCodes.merchant
messageCodes.pfj
messageCodes.installmentIndex
messageCodes.installmentCount
messageCodes.installmentAmount
messageCodes.saleAmount
messageCodes.nsu
messageCodes.authorization
messageCodes.saleDate
messageCodes.dueDate
string4Campos e códigos de erros

Exemplos:

{
    "message": "Transações invalidas, por favor verificar a formatação ou validação dos dados de acordo com o payload abaixo e documentação da API.",
    "helpers": "https://concilcard.readme.io/reference#getting-started-with-your-api",
    "errors": [
      {
        "id": "1",
        "messageCodes": {
            "id": "0000", // fieldName: message code
            "acquirerId": "0000",
            "brandId": "0000",
            "productId": "0000",
            "branch": "0000",
            "merchant": "007",
            "pfj": "0000",
            "installmentIndex": "0000",
            "installmentCount": "0000",
            "installmentAmount": "0000",
            "saleAmount": "0000",
            "nsu": "012",
            "authorization": "012",
            "saleDate": "0000",
            "dueDate": "0000"
            }
       }...
    ]
}

🚧

Bad requests status code 400

Requisições com payloads inválidos não são processadas.

Abaixo estão especificadas as possíveis mensagens de erro para requests recusadas com o status code response 400 no serviço de Requisição de envio de vendas, , referentes a parâmetros inválidos informados no payload. Essas informações se referem a critérios utilizados na conciliação de vendas e por isso é essencial que sejam informados corretamente para maior assertividade e desempenho da conciliação.

CódigoO que devo fazer?
0000Nada, pois este campo é valido
0001Código id inválido. Seu preenchimento é obrigatório, pois utilizamos esse dado para relacionar e baixar suas vendas no retorno de pagamentos
0002acquirerId não localizado, por favor validar a tabela de adquirentes disponível na documentação Acquirers
0003brandId não localizada, por favor validar a tabela de bandeiras disponível na documentação Brands
0004productId não localizado, por favor validar a tabela de produtos disponível na documentação Products
0005branch não localizada, por favor validar sua base de cadastro antes de importação, através do recurso de /entity/branchs Requisição de Branchs.
0006Este pfj é inválido e não está relacionado a apikey informada, por favor verificar a apikey correta para esta importação
0007merchant não localizado na branch, por favor validar sua base de cadastro antes da importação, através do recurso de /entity/merchants /entity/merchants. Requisição de Merchants.
0008saleAmount (valor bruto da venda) inválido. Seu preenchimento é obrigatório, pois utilizamos como critério de conciliação
0009installmentIndex (número da parcela) inválido. Seu preenchimento é obrigatório, pois utilizamos como critério de conciliação
0010installmentCount (total de parcelas) inválido. Seu preenchimento é obrigatório, pois utilizamos como critério de conciliação
0011installmentAmount (valor da parcela bruto) inválido. Seu preenchimento é obrigatório, pois utilizamos como critério de conciliação
0012O preenchimento da autorização ou nsué obrigatório, ou seja, um dos dois parâmetros devem ser preenchidos
0013Formato de data inválido. O padrão correto é YYYYMMDD
0014A precisão do campo número de cartão cardNumber é de até 20 caracteres