...
Nome | Tipo | Obrigatório | Informações |
|---|---|---|---|
id_omni_debito | Número | Sim | Atributo do tipo primary key. Este atributo deve ser um número único por registro. |
id_operadora | Número | Sim | Atributo fixo o valor = 1, quanto view for implementado pela operadora. |
instancia_aplicacao | Texto | Sim | Atributo fixo no valor = '1', quanto view ou tabela for implementado pela operadora. |
id_config_cliente_app | Número | Sim | Atributo fixo no valor = 1, quanto view ou tabela for implementado pela operadora. |
chave_unica | Texto | Sim | Chave de identificação única por beneficiário. Não deve se repetir em nenhuma hipótese. |
numero_contrato | Texto | Sim | Número do contrato vinculado a este debito. Este código deve ter relação com o código do contrato do usuário logado. |
cnpj | Texto | Sim | Informar CNPJ da operadora (somente números). Este atributo é utilizado para identificar os dados da operadora, bem como seus dados bancários. |
conta_corrente | Texto | Sim | Informar a conta corrente completa que será exibida no boleto gerado pelo OMNILINK (ou seja, da sua empresa). Exemplo: 349454-4 |
agencia | Texto | Sim | Informar a agência completa que será exibida no boleto gerado pelo OMNILINK (ou seja, da sua empresa). Exemplo: 3154-8 |
banco | Texto | Sim | Código do banco do título (informar somente código) que será exibido no boleto gerado pelo OMNILINK (ou seja, da sua empresa). Exemplo: 001 - Quando refere-se ao Banco do Brasil 237 - Quando refere-se ao Bradesco E assim por diante. Atributo servirá para buscar dados bancários. |
id_titulo | Número | Sim | Id de banco de dados do título no seu sistema interno, não pode se repetir. Se o seu sistema exigir o id do título como chave para localizar o mesmo nos demais métodos, este campo deverá ser considerado obrigatório. Somente números (Não podem existir letras, espaços em branco, ou pontos decimais). |
codigo_titulo | Texto | Sim | Código do título no seu sistema interno, exemplo “MS00579”, não pode se repetir. Formato: Texto livre. |
data_emissao | Texto | Sim | Formato: YYYY-MM-DD Informe a data do pagamento do débito. Este campo deve ser informado caso a propriedade ‘situacao_id’ for igual a B, de baixado. |
data_processamento | Texto | Sim | Formato: YYYY-MM-DD |
data_pagamento | Texto | Condicional | Formato: YYYY-MM-DD Informe a data do pagamento do débito. Este campo deve ser informado caso a propriedade ‘situacao_id’ for igual a B, de baixado. |
situacao_id | Texto | Sim | Tipos FIXOS. Serão permitidos APENAS os seguintes: P - A Vencer (em aberto porém ainda não está vencido). A = Atrasado (em aberto, porém já vencido). B = Baixado (já foi pago). Caso envie algo diferente desse conteúdo, o status do boleto não será exibido. |
situacao_descricao | Texto | Sim | O que for informado neste campo será exibido como descrição. Exemplos: A vencer Atrasado Baixado |
situacao_cor | Texto | Sim | Hexadecimal. Informe o código da cor que deseja exibir este débito. Importante: enviar com o # Exemplo: Caso não informado o aplicativo utilizará a tabela de cor padrão. |
tipo_cobranca_id | Texto | Sim | C = Consignação B = Boleto. D = Débito em conta. IMPORTANTE: A linha digitável só será exibida caso o tipo_cobranca_id for “B” |
tipo_cobranca_descricao | Texto | Sim | Descrição da situação do débito Consignação / desconto em folha. Boleto Débito em conta |
tipo_cobranca_cor | Texto | Sim | Hexadecimal. Informe o código da cor que deseja exibir este débito. Importante: enviar com o # Exemplo: Caso não informado o aplicativo utilizará a tabela de cor padrão. |
descricao | Texto | Não | Utilize este campo para adicionar uma descrição do título na lista de boletos. Este campo é ideal para identificar, na listagem de títulos, se trata-se de um documento de cobrança relacionado a coparticipação, titulo de mensalidade ou de renegociação. |
fatura_digital | Número | Não | Utilize este campo para informar se o contratante fez adesão à fatura digital para este contrato. Conteúdos aceitos: 0 = Não 1 = Sim |
debito_automatico | Número | Não | Utilize este campo para informar se a forma de pagamento deste contrato é Débito Automático. Conteúdos aceitos: 0 = Não 1 = Sim |
observacao | Texto | Não | Informe um texto de observação para ser apresentado na tela de detalhes do boleto. Este texto será apresentado abaixo da linha digitável, em destaque. |
informacoes | Texto | Não | Utilize este campo para apresentar informações ao pagador. Você pode utilizar este espaço para justificar eventuais alterações de valores por motivo de atraso no pagamento. |
valor_original | Número | Não | Informe o valor original do título antes de sofrer eventuais ajustes de multas por atraso. Numérico, 2 posições decimais. Indicador decimal = PONTO (9999999.99) |
vencimento_original | Texto | Não | Formato: YYYY-MM-DD Informe a data de vencimento original do título antes de sofrer alteração em função de acordos. |
alerta_mensagem | Texto | Opcional | Esta mensagem será exibida no documento de cobrança, em destaque. Utilize para destacar uma informação relevante na listagem de débitos. |
alerta_cor | Texto | Condicional | Caso o campo alerta_mensagem contenha algum conteúdo (diferente de vazio), esse campo torna-se obrigatório. A cor precisa estar no formato hexadecimal. Importante: enviar com o # Exemplo: Caso não seja informada a cor, o validador de integração vai rejeitar sua integração. |
alerta_icone | Texto | Opcional | Indique o ícone de sua preferência. Caso não seja indicado, o app vai escolher o ícone padrão. A lista de ícones suportadas está descrita no fim dessa documentação. |
instrucao_boleto | Texto | Condicional | Texto para preencher o espaço de “Instruções” da ficha de compensação do Boleto. |
desconto_abatimento | Número | Condicional | Numérico, 2 posições decimais. Indicador decimal = PONTO (9999999.99) Obrigatório quando a forma de cobrança for do tipo Boleto, ou seja, tipo_cobranca_id = 'B' e caso tenha descontos a lançar. |
outras_deducoes | Número | Condicional | Numérico, 2 posições decimais. Indicador decimal = PONTO (9999999.99) Obrigatório quando a forma de cobrança for do tipo Boleto, ou seja, tipo_cobranca_id = 'B' e caso tenha outras deduções a lançar. |
mora_multa | Número | Condicional | Numérico, 2 posições decimais. Indicador decimal = PONTO (9999999.99) Obrigatório quando a forma de cobrança for do tipo Boleto, ou seja, tipo_cobranca_id = 'B' e caso tenha mora ou multa a lançar. |
outros_acrescimos | Número | Condicional | Numérico, 2 posições decimais. Indicador decimal = PONTO (9999999.99) Obrigatório quando a forma de cobrança for do tipo Boleto, ou seja, tipo_cobranca_id = 'B' e caso tenha outros acréscimos a lançar. |
local_pagamento | Texto | Condicional | Informação sobre local de pagamento. Obrigatório quando a forma de cobrança for do tipo Boleto, ou seja, tipo_cobranca_id = 'B' e caso tenha outros acréscimos a lançar. |
especie_documento | Texto | Sim | Retornar a sigla da especie do documento. |
numero_documento | Texto | Condicional | Número do documento criado pelo sistema da operadora. Obrigatório quando a forma de cobrança for do tipo Boleto, ou seja, tipo_cobranca_id = 'B' e caso tenha outros acréscimos a lançar. |
solicita_confirmacao | Texto | Sim | Informe FALSE. Motivo: Reservado para implementação futura |
texto_confirmacao | Texto | Condicional | Deixar em branco |
btn_comp_pag_ativo | Texto | Sim | INFORME SEMPRE FALSE. Motivo: Reservado para implementação futura |
btn_comp_pag_label | Texto | Condicional | Deixar em branco |
btn_res_cobr_ativo | Texto | Sim | Informe TRUE caso deseje exibir o botão de “Resumo de cobrança” para o débito em questão. Caso não deseje exibir esse botão, informe FALSE. |
btn_res_cobr_label | Texto | Condicional | Texto que será exibido no botão que exibe o resumo da cobrança na tela de detalhes do débito. Caso campo btn_res_cobr_ativo seja TRUE, esse campo torna-se obrigatório. Caso contrário, deixe o atributo em branco. |
btn_boleto_pdf_ativo | Texto | Sim | Informe TRUE caso deseje exibir o botão de “Boleto em PDF” para o débito em questão. Caso não deseje exibir esse botão, informe FALSE. Exemplo: em débitos já quitados, é comum não exibir o boleto, evitando pagamento em duplicidade. Portanto, sugerimos que quando o débito esteja com status PAGO, esse campo esteja com conteúdo FALSE. |
btn_boleto_pdf_label | Texto | Condicional | Texto que será exibido no botão que exibe o boleto em PDF na tela de detalhes do débito. Caso campo btn_boleto_pdf_ativo seja TRUE, esse campo torna-se obrigatório. Caso contrário, deixe o atributo em branco. |
nosso_numero | Texto | Não | Preencher com o “Nosso Número”. Em boletos registrados, essa informação deve existir. |
digito_nosso_numero | Texto | Não | Preencher com o Dígito do Nosso Número. Em boletos registrados, essa informação deve existir. |
carteira | Texto | Não | Indique a carteira de cobrança dessa cobrança. Em boletos registrados, essa informação deve existir. |
moeda | Texto | Não | Caso seja um boleto, geralmente é indicado preencher "REAL”. |
...