org.jrimum.bopepo.campolivre.CLSicredi Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of bpp-cobranca Show documentation

This is a fork and merge from JRimum ( http://www.jrimum.org ), - Bopepo: https://github.com/jrimum/bopepo - Texgit: https://github.com/jrimum/texgit - Valia: https://github.com/jrimum/vallia - Utilix: https://github.com/jrimum/utilix - Domkee: https://github.com/jrimum/domkee For Brazillian Boleto Payment Method. So much thanks for original authors: Gilmar P. S. L, Misael Barreto and Rômulo Augusto.

The newest version!

/* 
 * Copyright 2010 JRimum Project
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 * use this file except in compliance with the License. You may obtain a copy of
 * the License at http://www.apache.org/licenses/LICENSE-2.0
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.
 * 
 * Created at: 15/01/2010 - 20:40:59
 *
 * ================================================================================
 *
 * Direitos autorais 2010 JRimum Project
 *
 * Licenciado sob a Licença Apache, Versão 2.0 ("LICENÇA"); você não pode 
 * usar esse arquivo exceto em conformidade com a esta LICENÇA. Você pode obter uma 
 * cópia desta LICENÇA em http://www.apache.org/licenses/LICENSE-2.0 A menos que 
 * haja exigência legal ou acordo por escrito, a distribuição de software sob esta 
 * LICENÇA se dará “COMO ESTÁ”, SEM GARANTIAS OU CONDIÇÕES DE QUALQUER TIPO, sejam 
 * expressas ou tácitas. Veja a LICENÇA para a redação específica a reger permissões 
 * e limitações sob esta LICENÇA.
 * 
 * Criado em: 15/01/2010 - 20:40:59
 * 
 */

package org.jrimum.bopepo.campolivre;

import static java.lang.String.format;
import static java.math.BigDecimal.ZERO;
import static org.jrimum.bopepo.parametro.ParametroBancoSicredi.POSTO_DA_AGENCIA;

import org.jrimum.domkee.banco.Titulo;
import org.jrimum.texgit.Fillers;
import org.jrimum.texgit.FixedField;
import org.jrimum.utilix.Objects;
import org.jrimum.vallia.Modulo;
import org.jrimum.vallia.TipoDeModulo;

/**
 * 
 * O campo livre do banco Sicredi deve seguir esta forma:
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * 
 * Posição Tamanho Picture Conteúdo (terminologia padrão) Conteúdo (terminologia do banco)
 20-20 1 tipo de cobrança: "1" ou "3" Código numérico correspondente ao tipo de cobrança: "1"- Com Registro ou "3"- Sem Registro
21-21 1 Constante correspondente ao tipo de carteira: "1"- carteira simples. Embora no código fonte do manual mencione outras duas possibilidades "2"-Caucionada ou "3"-Descontada. Código númerico correspondente ao tipo de carteira: "1" - carteira simples
22-29 8 Nosso Número (8) Nosso Número
30-30 1 DV do Nosso Número (1) Dígito Verificador do Nosso Número
31-34 4 Cooperativa de crédito / agência cedente Cooperativa de crédito / agência cedente
35-36 2 Unidade de atendimento / posto da agênica cedente Unidade de atendimento / posto da agênica cedente
37-41 5 Código do Cedente Código do Cedente
42-42 1 Filler: 1 (um) quando o campo "valor do documento" diferente de 0 (zero), caso contrário zero. 1 (um) quando o campo "valor do documento" diferente de 0 (zero), caso contrário zero.
43-43 1 Constante "0"- Zero Zero Fixo
44-44 1 Dígito verificador do campo livre calculado por módulo 11 com aproveitamento total (resto igual a (0) zero ou (1) um o Dígito será (0) zero) Dígito verificador do campo livre calculado por módulo 11 com aproveitamento total (resto igual a (0) zero ou (1) um o Dígito será (0) zero)
 * 
 * @see org.jrimum.bopepo.campolivre.AbstractCampoLivre
 * 
 * @author Gilmar P.S.L
 * 
 * @since 0.2
 * 
 * @version 0.2
 */
class CLSicredi extends AbstractCLSicredi {

	/**
	 * {@code serialVersionUID = 7697120719706717353L}
	 */
	private static final long serialVersionUID = 7697120719706717353L;
	
	/**
	 * Número de campos = 10.
	 */
	private static final Integer FIELDS_LENGTH = 10;

	/**
	 * Código númerico correspondente ao tipo de cobrança: "1" - Com Registro.
	 */
	private static final String COBRANCA_COM_REGISTRO = "1";
	
	/**
	 * Código númerico correspondente ao tipo de cobrança: "3" - Sem Registro.
	 */
	private static final String COBRANCA_SEM_REGISTRO = "3";

	/**
	 * Valor constante do campo "Tipo da Carteira": "1" - carteira simples.
	 */
	private static final Integer CARTEIRA_SIMPLES_VALUE = Integer.valueOf(1);
	
	/**
	 * Segunda posição do campo livre.
	 */
	private static final FixedField FIELD_CARTEIRA = new FixedField(CARTEIRA_SIMPLES_VALUE, 1);
	
	/**
	 * Instância de módulo 11 para cálculo do DV do campo livre.   
	 */
	private static final Modulo modulo11 = new Modulo(TipoDeModulo.MODULO11);

	/**
	 * Cria um campo livre instanciando o número de fields ({@code FIELDS_LENGTH}) deste campo.
	 * 
	 * @since 0.2
	 */
	protected CLSicredi() {
		
		super(FIELDS_LENGTH);
	}
	
	/**
	 * {@inheritDoc}
	 * 
	 * @see org.jrimum.bopepo.campolivre.AbstractCampoLivre#checkValues(org.jrimum.domkee.financeiro.banco.febraban.Titulo)
	 */
	@Override
	protected void checkValues(Titulo titulo){
		
		checkCarteiraNotNull(titulo);
		checkCodigoDaCarteira(titulo);
		checkCarteiraSimples(titulo);
		checkRegistroDaCarteiraNotNull(titulo);
		checkNossoNumero(titulo);
		checkTamanhoDoNossoNumero(titulo, NN8);
		checkDigitoDoNossoNumero(titulo);
		checkTamanhoDigitoDoNossoNumero(titulo, 1);
		checkCodigoDaAgencia(titulo);
		checkCodigoDaAgenciaMenorOuIgualQue(titulo, 99999);
		checkParametroBancario(titulo, POSTO_DA_AGENCIA);
		checkNumeroDaContaNotNull(titulo);
		checkCodigoDoNumeroDaConta(titulo);
		checkCodigoDoNumeroDaContaMenorOuIgualQue(titulo, 99999);
		checkValor(titulo);
	}
	
	/**
	 *  {@inheritDoc}
	 *  
	 * @see org.jrimum.bopepo.campolivre.AbstractCampoLivre#addFields(org.jrimum.domkee.financeiro.banco.febraban.Titulo)
	 */
	@Override
	protected void addFields(Titulo titulo) {
		
		if(titulo.getContaBancaria().getCarteira().isComRegistro()){
			
			this.add(new FixedField(COBRANCA_COM_REGISTRO, 1));
			
		}else{
			
			this.add(new FixedField(COBRANCA_SEM_REGISTRO, 1));
		}
		
		this.add(FIELD_CARTEIRA);
		this.add(new FixedField(titulo.getNossoNumero(), 8, Fillers.ZERO_LEFT));
		this.add(new FixedField(titulo.getDigitoDoNossoNumero(), 1, Fillers.ZERO_LEFT));
		this.add(new FixedField(titulo.getContaBancaria().getAgencia().getCodigo(), 4, Fillers.ZERO_LEFT));
		this.add(new FixedField(titulo.getParametrosBancarios().getValor(POSTO_DA_AGENCIA), 2, Fillers.ZERO_LEFT));
		this.add(new FixedField(titulo.getContaBancaria().getNumeroDaConta().getCodigoDaConta(), 5, Fillers.ZERO_LEFT));
		
		if (titulo.getValor().compareTo(ZERO) == 1) {
			
			this.add(new FixedField("1", 1));
			
		} else {
			
			this.add(new FixedField("0", 1));
		}

		this.add(new FixedField("0", 1));
		this.add(new FixedField(calculeDigitoVerificador(), 1));
	}
	
	/**
	 * Verifica se o código da carteira da conta bancária do título é igual 1
	 * (carteira simples), caso contrário lança uma {@code
	 * IllegalArgumentException}.
	 * 
	 * @param titulo
	 */
	private void checkCarteiraSimples(Titulo titulo) {
		
		Objects.checkArgument(
				titulo.getContaBancaria().getCarteira().getCodigo().equals(CARTEIRA_SIMPLES_VALUE),
				format("Apenas a carteira de código [1] \"carteira simples\" é permitida e não o código [%s]!", titulo.getContaBancaria().getCarteira().getCodigo())
		);
	}

	/**
	 * Calcula o dígito verificador deste campo livre (posição 25 do campo livre
	 * 44 do código de barras) com módulo 11 a partir das 24 posições deste
	 * campo livre.
	 * 
	 * @return dígito verificador
	 * 
	 * @since 0.2
	 */
	private Integer calculeDigitoVerificador() {

		final int resto = modulo11.calcule(writeFields());

		if (resto == 0 || resto == 1) {

			return Integer.valueOf(0);
			
		} else{
			
			return Integer.valueOf(modulo11.valor() - resto);
		}
	}
	
}

Posição	Tamanho	Picture	Conteúdo (terminologia padrão)
20-20	1	tipo de cobrança: "1" ou "3"	Código numérico correspondente ao tipo de cobrança: "1"- Com Registro ou "3"- Sem Registro
21-21	1	Constante correspondente ao tipo de carteira: "1"- carteira simples. Embora no código fonte do manual mencione outras duas possibilidades "2"-Caucionada ou "3"-Descontada.	Código númerico correspondente ao tipo de carteira: "1" - carteira simples
22-29	8	Nosso Número (8)	Nosso Número
30-30	1	DV do Nosso Número (1)	Dígito Verificador do Nosso Número
31-34	4	Cooperativa de crédito / agência cedente	Cooperativa de crédito / agência cedente
35-36	2	Unidade de atendimento / posto da agênica cedente	Unidade de atendimento / posto da agênica cedente
37-41	5	Código do Cedente	Código do Cedente
42-42	1	Filler: 1 (um) quando o campo "valor do documento" diferente de 0 (zero), caso contrário zero.	1 (um) quando o campo "valor do documento" diferente de 0 (zero), caso contrário zero.
43-43	1	Constante "0"- Zero	Zero Fixo
44-44	1	Dígito verificador do campo livre calculado por módulo 11 com aproveitamento total (resto igual a (0) zero ou (1) um o Dígito será (0) zero)	Dígito verificador do campo livre calculado por módulo 11 com aproveitamento total (resto igual a (0) zero ou (1) um o Dígito será (0) zero)