{"__v":27,"_id":"57602fd666b6b72400f8d2b4","category":{"__v":0,"_id":"57604518b82256240055c722","project":"575aeffae12cf20e002f306c","version":"575aeffae12cf20e002f306f","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-06-14T17:55:36.688Z","from_sync":false,"order":17,"slug":"dúvidas-fale-conosco","title":"Dúvidas?"},"parentDoc":null,"project":"575aeffae12cf20e002f306c","user":"57601a13af3e090e00108059","version":{"__v":29,"_id":"575aeffae12cf20e002f306f","project":"575aeffae12cf20e002f306c","createdAt":"2016-06-10T16:51:06.080Z","releaseDate":"2016-06-10T16:51:06.080Z","categories":["575aeffae12cf20e002f3070","575af039a083950e004487f7","575af5c7ba4ed70e000ca288","57602fe5b82256240055c657","57602ff6c811102000cef302","576030909b1a9a220067ca40","57604518b82256240055c722","5761a63d207db7170022fc14","5761b9a2b65324200072d79e","576832939f0bf4190014ffdf","576832c09f0bf4190014ffe1","576832cba151c10e004316f0","576832d5bb15f40e00a288ec","576832e107b1f30e0039c645","577680bf3cee3a0e00a000bc","577ff3b1ff48990e000c6806","5783f78c5cbce30e0074e2b7","5783f86292edb92200e6101c","5783f86dbfbba719003f0d8b","5783f8755cbce30e0074e2b8","5783f8b65cbce30e0074e2b9","5783f8bf5cbce30e0074e2ba","5783f8d8ce802f0e0087d574","578529f887c9280e0090394b","57852aeb87c9280e0090394d","57866e72b2f4060e00fa39ca","57ab6d5c39c2fd1900191879","57f39451ab0ee12000bef915","582499a0d90fa027009b259e"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"2016","version_clean":"1.0.0","version":"1"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-06-14T16:24:54.315Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"Todo *endpoint* possui uma lista de códigos de erros que podem ser retornados em determinadas situações. Essa lista é importante para que o integrador consiga preparar sua integração para tratar todos os erros possíveis.\n\nPor exemplo: a API requer que o valor mínimo de uma cobrança seja de R$ 5,00, por isso, se o integrador tentar gerar uma cobrança com valor abaixo, será retornado um erro de código \"3500034\", que significa que *o valor total da cobrança deve ser maior ou igual a R$ 5,00*, ou seja, o integrador violou essa condição.\n\nConfira abaixo a relação dos códigos e o significado:\n\n<pre>**Código:** 3500000\n**Mensagem:** Erro interno do servidor.</pre>\n\n<pre>**Código:** 3500001\n**Mensagem:** A aplicação fornecida não tem permissão para utilizar este endpoint.</pre>\n\n<pre>**Código:** 3500002\n**Mensagem:** O parâmetro [data] é obrigatório.</pre>\n\n<pre>**Código:** 3500007\n**Mensagem:** O tipo de pagamento informado na propriedade [type] não está disponível.</pre>\n\n<pre>**Código:** 3500008\n**Mensagem:** Requisição não autorizada.</pre>\n\n<pre>**Código:** 3500010\n**Mensagem:** A propriedade [%s] informada não existe.</pre>\n\n<pre>**Código:** 3500011\n**Mensagem:** Não é possível definir [instructions] e [configurations] ao mesmo tempo para o carnê.</pre>\n\n<pre>**Código:** 3500016\n**Mensagem:** A transação deve possuir um cliente antes de ser paga.</pre>\n\n<pre>**Código:** 3500021\n**Mensagem:** A propriedade [installments] não pode ser superior a 1 para assinaturas.</pre>\n\n<pre>**Código:** 3500023\n**Mensagem:** A propriedade [%s] é obrigatória.</pre>\n\n<pre>**Código:** 3500030\n**Mensagem:** Esta transação já possui uma forma de pagamento definida.</pre>\n\n<pre>**Código:** 3500032\n**Mensagem:** O plano não pode ser removido pois possui transações associadas.</pre>\n\n<pre>**Código:** 3500034\n**Mensagem:** O valor total da cobrança deve ser maior ou igual a R$ 5,00.</pre>\n\n<pre>**Código:** 3500036\n**Mensagem:** A forma de pagamento da transação não é boleto bancário.</pre>\n\n<pre>**Código:** 3500037\n**Mensagem:** A propriedade [%s] informada é inválida. Deve ser maior ou igual a data atual.</pre>\n\n<pre>**Código:** 3500038\n**Mensagem:** Apenas transações com status [waiting] ou [unpaid] podem ser atualizadas.</pre>\n\n<pre>**Código:** 3500039\n**Mensagem:** A propriedade [send_to] é obrigatória para solicitação de envio pelos correios.</pre>\n\n<pre>**Código:** 3500040\n**Mensagem:** Apenas assinaturas com status [new] ou [active] podem ser canceladas.</pre>\n\n<pre>**Código:** 3500041\n**Mensagem:** A propriedade [repeats] deve ser maior ou igual a dois.</pre>\n\n<pre>**Código:** 3500042\n**Mensagem:** O parâmetro [data] deve ser um JSON.</pre>\n\n<pre>**Código:** 3500043\n**Mensagem:** Apenas transações com status [new], [waiting] ou [unpaid] podem ser canceladas.</pre>\n\n<pre>**Código:** 3500044\n**Mensagem:** A transação não pode ser paga pois possui o status [%s].</pre>\n\n<pre>**Código:** 3500048\n**Mensagem:** A transação [%s] não pode ser enviada pelos correios.</pre>\n\n<pre>**Código:** 3500050\n**Mensagem:** O identificador de conta fornecido é inválido.</pre>\n\n<pre>**Código:** 3500051\n**Mensagem:** É necessário chamar a função $gn.ready.</pre>\n\n<pre>**Código:** 3500052\n**Mensagem:** A função de callback é obrigatória.</pre>\n\n<pre>**Código:** 3500053\n**Mensagem:** O parâmetro [total] é obrigatório e deve ser um inteiro.</pre>\n\n<pre>**Código:** 3500054\n**Mensagem:** O parâmetro [brand] é obrigatório.</pre>\n\n<pre>**Código:** 3500055\n**Mensagem:** O parâmetro [card_data] deve ser um objeto.</pre>\n\n<pre>**Código:** 3500056\n**Mensagem:** O parâmetro [brand] informado é inválido. As opções válidas são: 'visa', 'mastercard', 'amex', 'diners', 'discover', 'jcb', 'elo' or 'aura'.</pre>\n\n<pre>**Código:** 3500057\n**Mensagem:** O parâmetro [number] é obrigatório.</pre>\n\n<pre>**Código:** 3500058\n**Mensagem:** O parâmetro [number] informado é inválido.</pre>\n\n<pre>**Código:** 3500059\n**Mensagem:** O parâmetro [cvv] é obrigatório.</pre>\n\n<pre>**Código:** 3500060\n**Mensagem:** O parâmetro [expiration_month] é obrigatório.</pre>\n\n<pre>**Código:** 3500061\n**Mensagem:** O parâmetro [expiration_year] é obrigatório.</pre>\n\n<pre>**Código:** 3500062\n**Mensagem:** O parâmetro [expiration_month] informado é inválido.</pre>\n\n<pre>**Código:** 3500063\n**Mensagem:** O parâmetro [available_payment_forms] é obrigatório.</pre>\n\n<pre>**Código:** 3500064\n**Mensagem:** O parâmetro [available_payment_forms] informado é inválido. As opções disponíveis são: 'banking_billet' and 'credit_card'.</pre>\n\n<pre>**Código:** 3500065\n**Mensagem:** Os parâmetros são obrigatórios.</pre>\n\n<pre>**Código:** 3500066\n**Mensagem:** Apenas transações com status [waiting] podem ser atualizadas.</pre>\n\n<pre>**Código:** 3500068\n**Mensagem:** Apenas carnês com status [active] podem ser atualizados.</pre>\n\n<pre>**Código:** 4600001\n**Mensagem:** Pagamento não encontrado.</pre>\n\n<pre>**Código:** 4600005\n**Mensagem:** O saldo da conta é insuficiente para efetuar a transação.</pre>\n\n<pre>**Código:** 4600007\n**Mensagem:** A data do vencimento do boleto deve ser maior ou igual que a data atual.</pre>\n\n<pre>**Código:** 4600008\n**Mensagem:** A data de vencimento mínima para emissão com envio pelos correios é inválida.</pre>\n\n<pre>**Código:** 4600033\n**Mensagem:** Conta bloqueada para realizar emissões.</pre>\n\n<pre>**Código:** 4600034\n**Mensagem:** A transação ultrapassa o limite de emissão da conta.</pre>\n\n<pre>**Código:** 4600035\n**Mensagem:** Serviço indisponível para a conta. Por favor, solicite que o recebedor entre em contato com o suporte Gerencianet.</pre>\n\n<pre>**Código:** 4600037\n**Mensagem:** O valor da emissão é superior ao limite operacional da conta. Por favor, solicite que o recebedor entre em contato com o suporte Gerencianet.</pre>\n\n<pre>**Código:** 4600059\n**Mensagem:** O número máximo de folhas por carnê é 12.</pre>\n\n<pre>**Código:** 4600060\n**Mensagem:** A data informada é inválida.</pre>\n\n<pre>**Código:** 4600100\n**Mensagem:** Timeout: Não foi possível validar os dados enviados. Por favor, tente novamente mais tarde.</pre>\n\n<pre>**Código:** 4600142\n**Mensagem:** Transação não processada por conter incoerência nos dados cadastrais.</pre>\n\n<pre>**Código:** 4600202\n**Mensagem:** O envio de CPF e/ou CNPJ é obrigatório.</pre>\n\n<pre>**Código:** 4600209\n**Mensagem:** Limite de emissões diárias excedido. Por favor, solicite que o recebedor entre em contato com o suporte Gerencianet.</pre>\n\n<pre>**Código:** 4600210\n**Mensagem:** não é possível emitir três emissões idênticas. Por favor, entre em contato com nosso suporte para orientações sobre o uso correto dos serviços Gerencianet.</pre>\n\n<pre>**Código:** 4600212\n**Mensagem:** Número de telefone já associado a outro CPF. Não é possível cadastrar o mesmo telefone para mais de um CPF.</pre>\n\n<pre>**Código:** 4600218\n**Mensagem:** E-mail já associado a outro CPF. Não é possível cadastrar o mesmo e-mail para mais de um CPF.</pre>\n\n<pre>**Código:** 4600222\n**Mensagem:** Recebedor e cliente não podem ser a mesma pessoa.</pre>\n\n<pre>**Código:** 4600224\n**Mensagem:** Problemas na validação da autorização do App. Por favor, solicite que o recebedor entre em contato com o suporte Gerencianet</pre>\n\n<pre>**Código:** 4600439\n**Mensagem:** O cancelamento de todas as lâminas só pode ser feito para carnês e a partir da primeira lâmina</pre>","excerpt":"Você está em: *\"Dúvidas > Códigos de Erros\"*","slug":"codigos-de-erros","type":"basic","title":"Códigos de Erros"}

Códigos de Erros

Você está em: *"Dúvidas > Códigos de Erros"*

Todo *endpoint* possui uma lista de códigos de erros que podem ser retornados em determinadas situações. Essa lista é importante para que o integrador consiga preparar sua integração para tratar todos os erros possíveis. Por exemplo: a API requer que o valor mínimo de uma cobrança seja de R$ 5,00, por isso, se o integrador tentar gerar uma cobrança com valor abaixo, será retornado um erro de código "3500034", que significa que *o valor total da cobrança deve ser maior ou igual a R$ 5,00*, ou seja, o integrador violou essa condição. Confira abaixo a relação dos códigos e o significado: <pre>**Código:** 3500000 **Mensagem:** Erro interno do servidor.</pre> <pre>**Código:** 3500001 **Mensagem:** A aplicação fornecida não tem permissão para utilizar este endpoint.</pre> <pre>**Código:** 3500002 **Mensagem:** O parâmetro [data] é obrigatório.</pre> <pre>**Código:** 3500007 **Mensagem:** O tipo de pagamento informado na propriedade [type] não está disponível.</pre> <pre>**Código:** 3500008 **Mensagem:** Requisição não autorizada.</pre> <pre>**Código:** 3500010 **Mensagem:** A propriedade [%s] informada não existe.</pre> <pre>**Código:** 3500011 **Mensagem:** Não é possível definir [instructions] e [configurations] ao mesmo tempo para o carnê.</pre> <pre>**Código:** 3500016 **Mensagem:** A transação deve possuir um cliente antes de ser paga.</pre> <pre>**Código:** 3500021 **Mensagem:** A propriedade [installments] não pode ser superior a 1 para assinaturas.</pre> <pre>**Código:** 3500023 **Mensagem:** A propriedade [%s] é obrigatória.</pre> <pre>**Código:** 3500030 **Mensagem:** Esta transação já possui uma forma de pagamento definida.</pre> <pre>**Código:** 3500032 **Mensagem:** O plano não pode ser removido pois possui transações associadas.</pre> <pre>**Código:** 3500034 **Mensagem:** O valor total da cobrança deve ser maior ou igual a R$ 5,00.</pre> <pre>**Código:** 3500036 **Mensagem:** A forma de pagamento da transação não é boleto bancário.</pre> <pre>**Código:** 3500037 **Mensagem:** A propriedade [%s] informada é inválida. Deve ser maior ou igual a data atual.</pre> <pre>**Código:** 3500038 **Mensagem:** Apenas transações com status [waiting] ou [unpaid] podem ser atualizadas.</pre> <pre>**Código:** 3500039 **Mensagem:** A propriedade [send_to] é obrigatória para solicitação de envio pelos correios.</pre> <pre>**Código:** 3500040 **Mensagem:** Apenas assinaturas com status [new] ou [active] podem ser canceladas.</pre> <pre>**Código:** 3500041 **Mensagem:** A propriedade [repeats] deve ser maior ou igual a dois.</pre> <pre>**Código:** 3500042 **Mensagem:** O parâmetro [data] deve ser um JSON.</pre> <pre>**Código:** 3500043 **Mensagem:** Apenas transações com status [new], [waiting] ou [unpaid] podem ser canceladas.</pre> <pre>**Código:** 3500044 **Mensagem:** A transação não pode ser paga pois possui o status [%s].</pre> <pre>**Código:** 3500048 **Mensagem:** A transação [%s] não pode ser enviada pelos correios.</pre> <pre>**Código:** 3500050 **Mensagem:** O identificador de conta fornecido é inválido.</pre> <pre>**Código:** 3500051 **Mensagem:** É necessário chamar a função $gn.ready.</pre> <pre>**Código:** 3500052 **Mensagem:** A função de callback é obrigatória.</pre> <pre>**Código:** 3500053 **Mensagem:** O parâmetro [total] é obrigatório e deve ser um inteiro.</pre> <pre>**Código:** 3500054 **Mensagem:** O parâmetro [brand] é obrigatório.</pre> <pre>**Código:** 3500055 **Mensagem:** O parâmetro [card_data] deve ser um objeto.</pre> <pre>**Código:** 3500056 **Mensagem:** O parâmetro [brand] informado é inválido. As opções válidas são: 'visa', 'mastercard', 'amex', 'diners', 'discover', 'jcb', 'elo' or 'aura'.</pre> <pre>**Código:** 3500057 **Mensagem:** O parâmetro [number] é obrigatório.</pre> <pre>**Código:** 3500058 **Mensagem:** O parâmetro [number] informado é inválido.</pre> <pre>**Código:** 3500059 **Mensagem:** O parâmetro [cvv] é obrigatório.</pre> <pre>**Código:** 3500060 **Mensagem:** O parâmetro [expiration_month] é obrigatório.</pre> <pre>**Código:** 3500061 **Mensagem:** O parâmetro [expiration_year] é obrigatório.</pre> <pre>**Código:** 3500062 **Mensagem:** O parâmetro [expiration_month] informado é inválido.</pre> <pre>**Código:** 3500063 **Mensagem:** O parâmetro [available_payment_forms] é obrigatório.</pre> <pre>**Código:** 3500064 **Mensagem:** O parâmetro [available_payment_forms] informado é inválido. As opções disponíveis são: 'banking_billet' and 'credit_card'.</pre> <pre>**Código:** 3500065 **Mensagem:** Os parâmetros são obrigatórios.</pre> <pre>**Código:** 3500066 **Mensagem:** Apenas transações com status [waiting] podem ser atualizadas.</pre> <pre>**Código:** 3500068 **Mensagem:** Apenas carnês com status [active] podem ser atualizados.</pre> <pre>**Código:** 4600001 **Mensagem:** Pagamento não encontrado.</pre> <pre>**Código:** 4600005 **Mensagem:** O saldo da conta é insuficiente para efetuar a transação.</pre> <pre>**Código:** 4600007 **Mensagem:** A data do vencimento do boleto deve ser maior ou igual que a data atual.</pre> <pre>**Código:** 4600008 **Mensagem:** A data de vencimento mínima para emissão com envio pelos correios é inválida.</pre> <pre>**Código:** 4600033 **Mensagem:** Conta bloqueada para realizar emissões.</pre> <pre>**Código:** 4600034 **Mensagem:** A transação ultrapassa o limite de emissão da conta.</pre> <pre>**Código:** 4600035 **Mensagem:** Serviço indisponível para a conta. Por favor, solicite que o recebedor entre em contato com o suporte Gerencianet.</pre> <pre>**Código:** 4600037 **Mensagem:** O valor da emissão é superior ao limite operacional da conta. Por favor, solicite que o recebedor entre em contato com o suporte Gerencianet.</pre> <pre>**Código:** 4600059 **Mensagem:** O número máximo de folhas por carnê é 12.</pre> <pre>**Código:** 4600060 **Mensagem:** A data informada é inválida.</pre> <pre>**Código:** 4600100 **Mensagem:** Timeout: Não foi possível validar os dados enviados. Por favor, tente novamente mais tarde.</pre> <pre>**Código:** 4600142 **Mensagem:** Transação não processada por conter incoerência nos dados cadastrais.</pre> <pre>**Código:** 4600202 **Mensagem:** O envio de CPF e/ou CNPJ é obrigatório.</pre> <pre>**Código:** 4600209 **Mensagem:** Limite de emissões diárias excedido. Por favor, solicite que o recebedor entre em contato com o suporte Gerencianet.</pre> <pre>**Código:** 4600210 **Mensagem:** não é possível emitir três emissões idênticas. Por favor, entre em contato com nosso suporte para orientações sobre o uso correto dos serviços Gerencianet.</pre> <pre>**Código:** 4600212 **Mensagem:** Número de telefone já associado a outro CPF. Não é possível cadastrar o mesmo telefone para mais de um CPF.</pre> <pre>**Código:** 4600218 **Mensagem:** E-mail já associado a outro CPF. Não é possível cadastrar o mesmo e-mail para mais de um CPF.</pre> <pre>**Código:** 4600222 **Mensagem:** Recebedor e cliente não podem ser a mesma pessoa.</pre> <pre>**Código:** 4600224 **Mensagem:** Problemas na validação da autorização do App. Por favor, solicite que o recebedor entre em contato com o suporte Gerencianet</pre> <pre>**Código:** 4600439 **Mensagem:** O cancelamento de todas as lâminas só pode ser feito para carnês e a partir da primeira lâmina</pre>