Parâmetros do boleto bancário
MODELOS DE IMPRESSÃO
- M1 – Um boleto por página SEM recibo (parte superior em branco);
- M2 – Dois boletos por página COM recibo;
- M3 – Três boletos por página;
- M4 – Não tem;
- M5 – Formato de carta.
PARÂMETROS PARA GERAÇÃO DE BOLETOS
Dados do pagador (sacado / cliente)
- PAGADOR_NOME – Nome do cliente/sacado (Letras);
- PAGADOR_DOCUMENTO – CPF ou CNPJ (Letras);
- PAGADOR_LOGRADOURO – Av. Luis Viana (Letras);
- PAGADOR_NUMERO – 6312 (Letras);
- PAGADOR_COMPLEMENTO– A 803 (Letras);
- PAGADOR_BAIRRO – Paralela (Letras);
- PAGADOR_MUNICIPIO – Ex: Salvador (Letras);
- PAGADOR_UF – Ex: BA (Letras);
- PAGADOR_CEP – 00000-000 (Letras);
- AVALISTA_NOME (Letras) – Se houver, normalmente fica em branco;
- AVALISTA_DOCUMENTO (Inteiro) – CPF ou CNPJ do avalisat a se houver, normalmente fica em branco.
Dados do beneficiário (cedente / cobrador)
- BENEFICIARIO_NOME – (Letras) Nome do beneficiário EX: “EMPRESA DEMONSTRACAO”.
- BENEFICIARIO_DOCUMENTO – CPF ou CNPJ (Letras);
- BENEFICIARIO_LOGRADOURO – (Letras) Endereço do emissor .Ex: “Av Luis Viana”;
- BENEFICIARIO_BAIRRO – Ex: CENTRO (Letras);
- BENEFICIARIO_CEP – Ex: 44.640-000 (Letras);
- BENEFICIARIO_UF – Ex: BA (Letras);
- BENEFICIARIO_MUNICIPIO – Ex: Salvador (Letras);
- BENEFICIARIO_EMAIL – (Letras);
- BENEFICIARIO_SITE – Site do emissor do boleto (Letras), não aparece em todos os modelos;
- BENEFICIARIO_COD_CLIENTE – Ver. documentação do banco se necessário (Santander) (Letras);
- BENEFICIARIO_LOGOMARCA – Caminho do arquivo de imagem JPEG ou PNG (Letras);
- BENEFICIARIO_TELEFONE – (Letras);
Dados da carteira
- BANCO – Código do banco na FEBRABAN (Ex: “033” – Santander);
- AGENCIA_NUMERO – (Letras);
- AGENCIA_DV – (Letras);
- CONTA_CORRENTE_NUMERO – (Letras);
- CONTA_CORRENTE_DV – (Letras);
- CARTEIRA – Código da carteira usada no calculo Ex: “006” (Letras);
- CARTEIRA_VARIACAO – Variação da carteira (vide cada banco);
- CARTEIRA_MODALIDADE – Variação/Modalidade da carteira;
- CARTEIRA_TIPO –
- Caixa usar: SICOB ou SIGCB: 14 ou 24
- CARTEIRA_CONVENIO
- CARTEIRA_CONVENIO_DV
- CARTEIRA_FORMATADA – Descrição da carteira para impressão no boleto;
- IOS – Ex: “000” (Usado pelo Santander) (Letras);
Descontinuado
- NUMERO_CONTRATO – (Letras) Usar CARTEIRA_CONVENIO;
- NUMERO_CONTRATO_DV – (Letras) Usar CARTEIRA_CONVENIO_DV;
- NUMERO_CONVENIO – (Letras) Usar CARTEIRA_CONVENIO e CARTEIRA_CONVENIO_DV.
Dados do documento que gerou a cobrança
- DOCUMENTO_ACEITE – “S” ou “N” (Letras);
- DOCUMENTO_DATA – Data do documento gerador do boleto (Ex: “22/05/2015”) (Data);
- DOCUMENTO_DESCRICAO – (Letras) Identificação interna do titulo na empresa (Seu número);
- DOCUMENTO_ESPECIE – “DS”, “DM” (Letras);
- DOCUMENTO_NUMERO – (Letras) – O número do documento (NF, O.S, Contrato…) que originou o boleto;
Dados do boleto
- NOSSO_NUMERO – Número único do boleto (Letras);
- VALOR_BOLETO – Valor do boleto, valor a ser cobrado (Numérico);
- VALOR_DESCONTOS – (Fracionado) Retornado no arquivo de retorno (Nas carteiras compatíveis);
- VALOR_RECEBIDO – (Fracionado) Retornado no arquivo de retorno (Nas carteiras compatíveis);
- DATA_VENCIMENTO (Data) – (EX: “30/06/2015”) (Data);
- PAGAMENTO_DATA_LIMITE (Data) – Data limite para pagamento do boleto;
- DATA_PROCESSAMENTO (Data) – (Ex: “23/06/2015”) (Data);
- DATA_EMISSAO – Data da emissão do documento que gerou o boleto (Data);
- MOEDA – Padrão “R$” (Letras);
- INSTRUCOES – Instruções ao agente bancário (o caixa), pode ter várias linhas (3 ou mais de acordo com o modelo) (Letras);
- LOCAL_PAGAMENTO1 – Primeira inicial do local de pagamento (Letras);
- LOCAL_PAGAMENTO2 – Segunda linha do local de pagamento (Letras);
- NOSSO_NUMERO_DV – Opcional, basta não informar que a API calcula automaticamente, ou informe para forçar um valor (Letras);
- BOLETO_CODIGO – Identificador do boleto no sistema de origem (Letras). É opcional e normalmente só utilizado nos WebServices.
- BOLETO_GERAR_PDF (Lógico) – Indica se o PDF do boleto deve ser gerado. É opcional e normalmente só utilizado nos WebServices.
- BOLETO_GERAR_PIX (Lógico) – Indica se o boleto gerado deve vir acompanhado do PIX correspondente. Se retornado pelo banco, o arquivo será informado no item ‘ARQUIVO_PDF‘;
- PIX_QRCODE (Letras) – Imagem do QR Code do PIX em Base64. Quando informada será adicionada a imagem do QR Code no boleto. (OBS: Não disponível em todos os modelos de impressão, testar se o modelo desejado já tem espaço para imagem do PIX.)
Arquivo de remessa
As rotinas de geração de arquivos de remessa exigem alguns dados adicionais:
- ARQUIVO_NUM_SEQUENCIAL – Número sequencial do arquivo enviado para o banco (Usado na CEF e SICOOB);
- BENEFICIARIO_CODIGO – Código identificador da empresa no banco; (Santander “SCCM”);
- ARQUIVO_DATA_GERACAO – Data de geração do arquivo de remessa (Opcional), vazio para hoje
- OCORRENCIA – “INCLUSAO” para inclusão (padrão), “EXCLUSAO” para código de baixa, ou o código da ocorrência no banco (ver manual do banco);
- JUROS_VALOR_DIARIO (Fracionado) – Valor dos juros diário;
- JUROS_PERCENTUAL_MENSAL (Fracionado) – Valor percentual dos juros por mês;
- MULTA_ATRASO_PERCENTUAL (Fracionado): Percentual de multa por atraso, informar 2,00 para 2,00% ou 0,15 para 0,15%…;
- – (Inteiro) Número de dias para protesto;
- DESCONTO_VALOR – Valor em R$ do desconto a ser aplicado para pagamento até a data limite (Fracionado);
- DESCONTO_DATA_LIMITE – Data limite para concessão do desconto (Data). (Opcional, e não suportado por todas as carteira);
- PROTESTO_DIAS_CORRIDOS antigo
DIAS_PROTESTOouPROTESTO_DIAS(Inteiro) – Números de dias para protesto após vencimento; - PROTESTO_DIAS_UTEIS (Inteiro) – Números de dias úteis para protesto após vencimento;
- NEGATIVAR_DIAS_UTEIS (Inteiro) – Números de dias úteis para negativação após vencimento;
- NEGATIVAR_DIAS_CORRIDOS (Inteiro) – Números de dias corridos para negativação após vencimento;
- INSTRUCAO_COBRANCA1 (Letras) – Texto/Código da primeira instrução de cobrança;
- INSTRUCAO_COBRANCA2 (Letras) – Texto/Código da segunda instrução de cobrança;
- DATA_INSTRUCAO (Data).
- INSTRUCOES_COBRANCA (Variante) – Lista com instruções de cobrança, cada instrução deve ser um mapeamento (Variante) dentro da lista, onde cada mapa pode conter:
-
- INSTRUCAO_COBRANCA_CODIGO (Letras) – Código da instrução;
- INSTRUCAO_COBRANCA_DIAS_UTEIS (Letras) – Dias úteis para execução da instrução;
- INSTRUCAO_COBRANCA_DIAS_CORRIDOS (Letras) – Dias corridos para execução da instrução;
- C000–999 – Campos personalizados podem ser informados passando parâmetros no seguinte formato:
- “C” + “POSICAO INICIAL” + “-” + “POSICAO FINAL” – O valor desta chave será utilizado para substituir o texto da linha nas colunas especificadas do inicio (inclusive) ao fim (inclusive), começando em 1 e indo até 400.
- Exemplos:
- “C15-25” – Substitui a posição 15 a 25 da linha;
- “C135-139” – Substitui a posição 135 a 139 da linha;
OBSERVAÇÕES
- Nem todos os parâmetros são obrigatórios, e nem todos os parâmetros informados são processados/aceitos pela instituição;
- Nem todos os dados são impressos nos boletos, de acordo com o modelo de impressão selecionado;
- Cada instituição financeira requer parâmetros diferentes, vide documentação do banco e da carteira para maiores detalhes.
PARÂMETROS DE RETORNO
A função retorna uma lista de mapas (Variante), cada mapa corresponde a um boleto, com os seguintes dados:
- CODIGO_BARRAS – Código de barras do boleto (Letras);
- LINHA_DIGITAVEL – Linha digitável (parte superior) completa do boleto(Letras);
- CAMPO_LIVRE – Campo com os dados específicos do banco / carteira(Letras);
- NOSSO_NUMERO_COMPLETO – Como impresso no boleto (Letras);
- NOSSO_NUMERO – Código único que identifica o boleto (Letras);
- NOSSO_NUMERO_DV – Dígito verificar do nosso número do boleto (Letras);
- ARQUIVO_PDF – Nome completo do arquivo PDF gerado (Letras);
WEBSERVICES
Os bancos que suportam chamadas via WebServices retornam adicionalmente:
- SUCESSO (Lógico) – Indica se a operação foi concluída com sucesso;
- ERRO_MENSAGEM (Letras) – Texto descritivo do erro;
- BOLETO_SITUACAO (Letras) – Retorna uma dessas situações se disponível no WebService “EM ABERTO“, “BAIXADO“, “LIQUIDADO“.
- BOLETO_URL (Letras) – URL para exibição do boleto gerado.
Utilize as funções de lista (‘Tamanho da Lista’, ‘Obter Objeto da Lista’, ..) e Mapeamento (‘Obter Elemento’, …) para ler os dados de retorno.