Manuais:E-Bank/FichaAceite

Como configurar a ficha de aceite do boleto?

Antes de tudo, veja como configurar o e-Bank no UniNFe e como utilizar o serviço do e-Bank Boleto.

Agora sim, podemos ver como é configurado a ficha de aceite do boleto que será registrado. Terá a seguinte estrutura após a tag <Especie> e antes da tag <IdentificacaoDistribuicao> do XML principal:

    ....
    ....
    ....
    <Especie>0</Especie>
    <FichaAceiteConfig>
	<FichaAceite>true</FichaAceite>
	<Merge>true</Merge>
	<AceiteDetails>
		<Aceite>true</Aceite>
		<AgenciaCodigoBeneficiario>string</AgenciaCodigoBeneficiario>
		<Beneficiario>string</Beneficiario>
		<Carteira>string</Carteira>
		<CodigoBanco>0</CodigoBanco>
		<DataDocumento>2025-03-12</DataDocumento>
		<DataProcessamento>2025-03-12</DataProcessamento>
		<Descontos>0</Descontos>
		<Especie>string</Especie>
		<Instrucoes>
			<Instrucao>string</Instrucao>
		</Instrucoes>
		<LogoBanco>string</LogoBanco>
		<MoraMulta>0</MoraMulta>
		<NossoNumero>string</NossoNumero>
		<NumeroDocumento>string</NumeroDocumento>
		<OutrasDeducoes>0</OutrasDeducoes>
		<OutrosAcrescimos>0</OutrosAcrescimos>
		<Pagador>string</Pagador>
		<RodapeDireito>
			<CodigoBarras>string</CodigoBarras>
			<TextoLivre>string</TextoLivre>
		</RodapeDireito>
		<RodapeEsquerdo>
			<CodigoBarras>string</CodigoBarras>
			<TextoLivre>string</TextoLivre>
		</RodapeEsquerdo>
		<Testing>true</Testing>
		<ValorCobrado>0</ValorCobrado>
		<ValorDocumento>0</ValorDocumento>
		<Vencimento>2025-03-12</Vencimento>
	</AceiteDetails>
    </FichaAceiteConfig>
    <IdentificacaoDistribuicao>0</IdentificacaoDistribuicao>
    ....
    ....
    ....

• Legenda das tags:
  • O grupo <FichaAceiteConfig> é responsável por reunir as configurações que serão da ficha de aceite:
    • A tag <FichaAceite> indica a criação da ficha de aceite caso seja true;
    • A tag <Merge> representa a unificação da ficha de aceite no mesmo PDF que o boleto se caso for true;
    • O grupo <AceiteDetails> indica a configuração para criação da ficha de aceite:
      • A tag <Aceite> representa o aceite ou confirmação do beneficiário no documento;
      • A tag <AgenciaCodigoBeneficiario> é o campo para informar o código da agência do beneficiário;
      • A tag <Beneficiario> é o nome do beneficiário do pagamento;
      • A tag <Carteira> é o campo para identificar a carteira de cobrança;
      • A tag <CodigoBanco> é o código do banco responsável pela cobrança;
      • A tag <DataDocumento> é a data do documento;
      • A tag <DataProcessamento> é a data de processamento do pagamento;
      • A tag <Descontos> é o valor dos descontos aplicados ao pagamento;
      • A tag <Especie> que especifica a espécie do título como "Duplicata" ou "Nota Promissória";
      • O grupo <Instrucoes> indica as instruções adicionais sobre o pagamento, como encargos ou informações sobre o boleto;
      • A tag <LogoBanco> é o caminho ou URL da logo do banco que emitiu o boleto;
      • A tag <MoraMulta> são as informações sobre a mora e multa aplicadas em caso de atraso;
      • A tag <NossoNumero> é o número do título, geralmente utilizado para identificar o pagamento;
      • A tag <NumeroDocumento> é o número do documento relacionado ao pagamento;
      • A tag <OutrasDeducoes> são as outras deduções que possam ser aplicadas no pagamento, como taxas extras;
      • A tag <Pagador> é o nome do pagador, que pode ser diferente do beneficiário;
      • o grupo <RodapeDireito> indica as informações que vão aparecer no rodapé do lado direito da ficha de aceite:
        • A tag <CodigoBarras> indica que é para imprimir o código de barras informado;
        • A tag <TextoLivre> é o campo para texto livre, que se informado, será impresso no rodapé;
      • o grupo <RodapeEsquerdo> indica as informações que vão aparecer no rodapé do lado esquerdo da ficha de aceite:
        • A tag <CodigoBarras> indica que é para imprimir o código de barras informado;
        • A tag <TextoLivre> é o campo para texto livre, que se informado, será impresso no rodapé;
      • A tag <ValorCobrado> é o valor total cobrado pelo pagamento, incluindo descontos e acréscimos;
      • A tag <ValorDocumento> é o valor original do documento, sem considerar descontos ou acréscimos;
      • A tag <Vencimento> é a data de vencimento do pagamento.

Veja também

• Como configurar o UniNFe para utilizar o e-Bank?
• Como utilizar o serviço do e-Bank Boleto?
• Como utilizar o serviço do e-Bank PIX?