Exibir origem

Contexto Geral

A API tem objetivo de consultar às movimentações de NF de cana com parâmetros obrigatórios e opcionais para buscas mais assertivas, incorporando:

Modelo de integração padronizado para orquestrar consultas e bloqueios.
Novo cadastro de status vinculado a um parâmetro de configuração da API que controla o comportamento dentro do TOTVS Agro Bioenergia.
Bloqueio de reversões já integradas em sistemas de origem do Bioenergia, preservando a integridade do processo.

Estruturas:

Cabeçalho (Header)
Campo	Tipo	Exemplo	Descrição
instancia	string	1	Identificador da instância
fgTpNota	string	Cana de Muda Mensal	Tipo da nota fiscal
noNf	integer	1	Número da NF
cdSerieNf	string	1	Série da NF
cdUnidInd	integer	1	Unidade industrial
cdTpProp	integer	2	Tipo de propriedade
cdUpnivel1	string	10005B	Código da UPNIVEL 1 (Ex. Fazenda)
deUpNivel1	string	SÃO PEDRO	Descrição da UPNIVEL 1 (Ex. Fazenda)
deNatOper	string	NOTA CANA MUDA	Natureza da operação
cdFiscOp	integer	1101	Código fiscal operação
cdFornec	integer	28785	Código do fornecedor
deFornec	string	TOTVS SA	Nome do fornecedor
cdSafra	integer	2016	Safra associada
amFornec	string(date-time)	2016-04-01T00:00:00	Mês/Ano referência fornecedor
acPeso	integer	156136	Peso acumulado
vlTotNf	number	10079.55	Valor total da NF
dtEmisNf	string(date-time)	2016-04-30T00:00:00	Data emissão NF
acTxContrib	number	231.83	Taxa contribuição acumulada
vlLiqNf	number	9847.72	Valor líquido NF
cdTpCalc	string/null	null	Tipo de cálculo
fgComplPreco	string/null	null	Flag complemento preço
deObs	string/null	null	Observação
deFiscOp	string/null	null	Descrição operação fiscal
cdClassFisc	string/null	null	Classificação fiscal
fgSubstituicao	string/null	null	Flag Substituição tributária
vlCredIcmsf	number/null	null	Crédito ICMS
fgAcertoAnual	string/null	null	Flag acerto anual
fgManAuto	string	M	Flag manual/automático
fgCpr	string/null	null	Flag CPR
fgIndividual	string/null	null	Flag individual
noContrCana	integer	1262	Contrato de cana
cdEmpresa	string	1	Código empresa
instContr	string	1	Instância contrato
cdMunic	string/null	null	Município
noNfCompl	integer/null	null	NF complementar
cdSerieNfCompl	string/null	null	Série NF complementar
noNfErpCompl	string/null	null	NF ERP complementar

Detalhe ( Detail)
Campo	Tipo	Exemplo	Descrição
cdUnidInd	integer	1	Unidade industrial
vlTonCana	number	57.38	Valor por tonelada
ddFim	integer	30	Dia fim do período
vlFatorK	number/null	null	Fator K
noNf	integer	1	Número NF
vlTotalServ	number/null	null	Valor total serviço
vlRef	number/null	null	Valor referência
qCanaEnt	integer	5073060	Quantidade cana entregue
vlTotal	number	291092.18	Valor total
cdSerieNf	string	1	Série NF
vlAcertoAtr	number/null	null	Valor acerto ATR
vlAcAtrReceb	number/null	null	Valor ATR recebido
instancia	string	1	Instância
vlKgAtr	number/null	null	Valor ATR/kg
cdTpCalc	string/null	null	Tipo cálculo
dataInicial	integer	1	Data inicial
pcPgVlTon	number/null	null	Percentual pagamento tonelada
vlBonusTon	number/null	null	Valor bônus tonelada

Histórico de Taxas
Campo	Tipo	Exemplo	Descrição
dtIniPer	string(date-time)	2016-04-01T00:00:00	Data início período
cdGrpTxContr	integer	1	Grupo taxa contribuição
instancia	string	1	Instância
cdUnidInd	integer	1	Unidade industrial
dtFimPer	string(date-time)	2016-04-30T00:00:00	Data fim período
vlTxContrib	number	6112.94	Valor taxa contribuição
cdTxContr	integer	1	Código taxa contribuição

Método GET:

http:127.0.0.1:8080/api/query/v1/canaMuda

{
    "hasNext": false,
    "items": [ {
            "instancia": "1",
            "fgTpNota": "Cana de Muda Mensal",
            "noNf": 1,
            "cdSerieNf": "1",
            "cdUnidInd": 1,
            "cdTpProp": 2,
            "cdUpnivel1": "10005B",
            "deUpNivel1": "SÃO PEDRO",
            "deNatOper": "NOTA CANA MUDA",
            "cdFiscOp": 1101,
            "cdFornec": 28785,
            "deFornec": "TOTVS SA",
            "cdSafra": 2016,
            "amFornec": "2016-04-01T00:00:00",
            "acPeso": 156136,
            "vlTotNf": 10079.55,
            "dtEmisNf": "2016-04-30T00:00:00",
            "acTxContrib": 231.83,
            "vlLiqNf": 9847.72,
            "cdTpCalc": null,
            "fgComplPreco": null,
            "deObs": null,
            "deFiscOp": null,
            "cdClassFisc": null,
            "dfSubstituicao": null,
            "vlCredIcmsf": null,
            "fgAcertoAnual": null,
            "fgManAuto": "M",
            "dfCpr": null,
            "fgIndividual": null,
            "noContrCana": 1262,
            "cdEmpresa": "1",
            "instContr": "1",
            "cdMunic": null,
            "noNfCompl": null,
            "cdSerieNfCompl": null,
            "noNfErpCompl": null,
            "detalheNfDeOut": [
                {
                    "cdUnidInd": 1,
                    "vlTonCana": 57.38,
                    "ddFim": 30,
                    "vlFatorK": null,
                    "noNf": 1,
                    "vlTotalServ": null,
                    "vlRef": null,
                    "qCanaEnt": 5073060,
                    "vlTotal": 291092.18,
                    "cdSerieNf": "1",
                    "vlAcertoAtr": null,
                    "vlAcAtrReceb": null,
                    "instancia": "1",
                    "detalheshistTxOut": [
                        {
                            "dtIniPer": "2016-04-01T00:00:00",
                            "cdGrpTxContr": 1,
                            "instancia": "1",
                            "cdUnidInd": 1,
                            "dtFimPer": "2016-04-30T00:00:00",
                            "vlTxContrib": 6112.94,
                            "cdTxContr": 1
                        }
                    ],
                    "vlKgAtr": null,
                    "cdTpCalc": null,
                    "dataInicial": 1,
                    "pcPgVlTon": null,
                    "vlBonusTon": null
                },
               
            ]
        }
     ]
}

Parâmetros Obrigatórios

instancia: Código da Instância.
fgTpNota: Flag Controlador de Tipo de Nota.

Parâmetros Opcionais

noNf: Número da Nota Fiscal.
cdSerieNf: Série da Nota Fiscal.
cdUnidInd: Código Unidade Industrial.

Atualizar status de integração - Notas Fiscais de Cana Muda

Disponibilizado endpoint para atualização do status de integração dos registros de Notas Fiscais de Cana Muda, considerando o retorno do processamento de integração e as regras de bloqueio de reversões definidas no módulo Bioenergia.

Método PUT:

http:127.0.0.1:8080/api/query/v1/canaMuda

Body da Requisição - Notas Fiscais de Cana Muda

{ "fgStatusIntegracao": "1",
  "instancia": "1",
  "fgTpNota": "1",
  "noNf": 1,
  "cdSerieNf": "1",
  "cdUnidInd": 1,
  "cdUpnivel1": "",
  "deFornec": ""
}

Com o objetivo de assegurar a consistência das informações integradas com outros sistemas, foi desenvolvido uma nova funcionalidade dentro da aplicação Configuração Central (CFGCEN/ TOTVS Agro Bioenergia), onde será possível realizar o cadastro de rotinas executadas pelo TOTVS Agro Bioenergia e indicar os possíveis "status de integração" vindos de sistemas externos (que estejam integrados ao TOTVS Agro Bioenergia).

Para cada status indicado, será possível apontar se será permitido ou não a reversão do processo em questão.

Visando possibilitar a indicação de diferentes cadastros para diferentes processamentos disponíveis em nosso sistema, foram criados parâmetros específicos para cada rotina,
onde o usuário deverá determinar qual cadastro deverá ser consultado no momento de realizar a reversão do processamento.

Importante frisar que, caso um ou mais registros apresentem um status onde esteja apontado o impedimento para reversão, o processamento será interrompido, impedindo a execução da reversão para todos os registros envolvidos.

Parâmetro "Código do cadastro de controle de status para NF de muda de cana":

Seção: RCMP_PGTCP;
Entrada: CD_CAD_STATUS_INT_NFM;

Para mais detalhes sobre a funcionalidade citada acima, acesse a página Cadastro de Bloqueio de Movimentações via API.