Histórico da Página

...

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:

Atributos	Descrição

Cabeçalho (Header)CampoDescrição

	Tipo

Exemplo

Observação
instancia

string1

Identificador da instância

fgTpNotastringCana de Muda Mensal

do processo	Numérico	Usado como chave de controle interno
cdTpNota	Código do tipo de

Tipo da

nota fiscal

noNfinteger1Número da NFcdSerieNfstring1Série da NFcdUnidIndinteger1Unidade industrialcdTpPropinteger2Tipo de propriedadecdUpnivel1string10005BCódigo da UPNIVEL 1 (Ex. Fazenda)deUpNivel1stringSÃO PEDRODescrição da UPNIVEL 1 (Ex. Fazenda)deNatOperstringNOTA CANA MUDANatureza da operaçãocdFiscOpinteger1101Código fiscal operaçãocdFornecinteger28785Código do fornecedordeFornecstringTOTVS SANome do fornecedorcdSafrainteger2016Safra associadaamFornecstring(date-time)2016-04-01T00:00:00Mês/Ano referência fornecedoracPesointeger156136Peso acumuladovlTotNfnumber10079.55Valor total da NFdtEmisNfstring(date-time)2016-04-30T00:00:00Data emissão NFacTxContribnumber231.83Taxa contribuição acumuladavlLiqNfnumber9847.72Valor líquido NFcdTpCalcstring/nullnullTipo de cálculofgComplPrecostring/nullnullFlag complemento preçodeObsstring/nullnullObservaçãodeFiscOpstring/nullnullDescrição operação fiscalcdClassFiscstring/nullnullClassificação fiscalfgSubstituicaostring/nullnullFlag Substituição tributáriavlCredIcmsfnumber/nullnullCrédito ICMSfgAcertoAnualstring/nullnullFlag acerto anualfgManAutostringMFlag manual/automáticofgCprstring/nullnullFlag CPRfgIndividualstring/nullnullFlag individualnoContrCanainteger1262Contrato de canacdEmpresastring1Código empresainstContrstring1Instância contratocdMunicstring/nullnullMunicípionoNfComplinteger/nullnullNF complementarcdSerieNfComplstring/nullnullSérie NF complementarnoNfErpComplstring/nullnullNF 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

Texto	D - Nota Cana de Muda Mensal R - Nota Cana de Revenda F - Nota Cana de Bisada G - Nota Cana sem Movimentação N - Nota Cana de Moagem S - Nota Cana Sobrepreço
deTpNota	Descrição do tipo de nota fiscal	Texto	Ex: “Nota Cana Sobrepreço”
noNf	Número da nota fiscal	Numérico	Identificação da NF
cdSerieNf	Série da nota fiscal	Texto	Série utilizada na emissão
cdUnidInd	Código da unidade industrial	Numérico	Refere-se à usina ou filial
cdTpProp	Código do tipo de propriedade	Numérico	Relacionado ao tipo de fornecedor (ex: próprio, parceria)
deNatOper	Descrição da natureza da operação	Texto	Ex: “COMPRA”
cdFiscOp	Código fiscal da operação	Numérico	Código CFOP ou equivalente
cdSafra	Código do ano-safra	Numérico	Ex: 2018
amFornec	Mês e ano de fornecimento	Data	Data base da operação
acPeso	Peso acumulado de cana entregue	Numérico	Em quilos
vlTotNf	Valor total da nota fiscal	Numérico	Valor bruto total
dtEmisNf	Data de emissão da NF	Data	Data em que a NF foi emitida
acTxContrib	Total de contribuições acumuladas	Numérico	Soma das taxas aplicadas
vlLiqNf	Valor líquido da nota fiscal	Numérico	Valor final após descontos
cdTpCalc	Código do tipo de cálculo	Numérico	Pode ser nulo
fgComplPreco	Indicador de complemento de preço	Texto	‘N’ = não é complemento
deObs	Observação da nota	Texto	Ex: “Nota Fiscal de Sobrepreço.”
deFiscOp	Descrição fiscal da operação	Texto	Pode ser nulo
cdClassFisc	Código de classificação fiscal	Numérico	Pode ser nulo
dfSubstituicao	Indicador de substituição fiscal	Texto	Pode ser nulo
vlCredIcmsf	Valor de crédito de ICMS	Numérico	Pode ser nulo
fgAcertoAnual	Indicador de acerto anual	Texto	‘N’ = não houve acerto anual
fgManAuto	Indicador de manutenção automática	Texto	‘A’ = automática
dfCpr	Indicador de CPR	Texto	Pode ser nulo
fgIndividual	Indicador de operação individual	Texto	Pode ser nulo
noContrCana	Número do contrato de cana	Numérico	Identifica o contrato associado
cdEmpresa	Código da empresa	Texto	Ex: “1”
instContr	Instância do contrato	Texto	Identifica a origem da NF
cdMunic	Código do município	Numérico	Pode ser nulo
noNfCompl	Número da NF complementar	Numérico	Pode ser nulo
cdSerieNfCompl	Série da NF complementar	Texto	Pode ser nulo
noNfErpCompl	Número ERP da NF complementar	Texto	Pode ser nulo

infoUpnivel1.cdUpnivel1	Código da unidade superior	Texto	Ex: “20003”
infoUpnivel1.deUpnivel1	Descrição da unidade superior	Texto	Ex: “TOTVS”
infoUpnivel1.cdFornec	Código do fornecedor	Numérico	Identificador ERP
infoUpnivel1.fgTpPess	Tipo de pessoa	Texto	‘J’ = Jurídica
infoUpnivel1.cdIntErp	Código integrado ERP	Texto	Identificação composta no ERP

infoFornecs.cdFornec	Código do fornecedor	Numérico	Identificação do fornecedor principal
infoFornecs.deFornec	Nome do fornecedor	Texto	Ex: “TOTVS FORN”
infoFornecs.fgTpFornec	Tipo de fornecedor	Texto	Ex: “2” = fornecedor
infoFornecs.deTpFornec	Descrição do tipo de fornecedor	Texto	1 - ACIONISTA 2 - FORNECEDOR 3 - EVENTUAL 4 - PROPRIO 5 - PARCEIRO
infoFornecs.fgTpPess	Tipo de pessoa	Texto	‘F’ = Física
infoFornecs.cdIntErp	Código integrado ERP	Texto	Código único no ERP

detalheNfDeOut.cdUnidInd	Código da unidade industrial (detalhe)	Numérico	Relaciona-se à usina
detalheNfDeOut.vlTonCana	Valor por tonelada de cana	Numérico	Valor unitário
detalheNfDeOut.ddFim	Dia final do período	Numérico	Ex: 31
detalheNfDeOut.vlFatorK	Fator K	Numérico	Pode ser nulo
detalheNfDeOut.qCanaEnt	Quantidade de cana entregue	Numérico	Em quilos
detalheNfDeOut.vlTotal	Valor total	Numérico	Soma geral do período
detalheNfDeOut.cdSerieNf	Série da nota (detalhe)	Texto	Ex: “5”
detalheNfDeOut.vlKgAtr	Valor do ATR (kg)	Numérico	Pode ser nulo
detalheNfDeOut.cdTpCalc	Código do tipo de cálculo	Numérico	Pode ser nulo
detalheNfDeOut.dataInicial	Dia inicial do período	Numérico	Ex: 1

detalheshistTxOut.dtIniPer	Data inicial do período da taxa	Data	Ex: “2018-05-01”
detalheshistTxOut.dtFimPer	Data final do período da taxa	Data	Ex: “2018-05-31”
detalheshistTxOut.vlTxContrib	Valor da contribuição	Numérico	Ex: 449.73
detalheshistTxOut.cdTxContr	Código da taxa de contrato	Numérico	Identificador da taxa

txContrib.deTxcontr	Descrição da taxa	Texto	Ex: “INSS” ou “SENAR”
txContrib.pcTxcontr	Percentual da taxa	Numérico	Ex: 1.3 ou 0.2
txContrib.cdIndBase	Código de índice base	Numérico	Ex: 950
txContrib.fgAcertoAno	Indicador de acerto anual da taxa	Texto	‘S’ = Sim
txContrib.codigoClassificacao	Código da classificação	Texto	Ex: “CLAS 1”
txContrib.codigoEspecie	Código da espécie	Texto	Ex: “ESPECIE 1”

Método GET:

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

Bloco de código

language	java
title	Body da Requisição - Notas Fiscais Cana Muda.

{
   "hasNext":true,
   "items":[
      {
         "instancia":"1",
         "cdTpNota":"S",
         "deTpNota":"Nota Cana Sobrepreço",
         "noNf":1,
         "cdSerieNf":"5",
         "cdUnidInd":1,
         "cdTpProp":5,
         "deNatOper":"COMPRA",
         "cdFiscOp":1101,
         "cdSafra":2018,
         "amFornec":"2018-05-01T00:00:00",
         "acPeso":4867980,
         "vlTotNf":34594.79,
         "dtEmisNf":"2018-05-22T00:00:00",
         "acTxContrib":518.92,
         "vlLiqNf":34075.87,
         "cdTpCalc":null,
         "fgComplPreco":"N",
         "deObs":"Nota Fiscal de Sobrepreço.",
         "deFiscOp":null,
         "cdClassFisc":null,
         "dfSubstituicao":null,
         "vlCredIcmsf":null,
         "fgAcertoAnual":"N",
         "fgManAuto":"A",
         "dfCpr":null,
         "fgIndividual":null,
         "noContrCana":2277,
         "cdEmpresa":"1",
         "instContr":"1",
         "cdMunic":null,
         "noNfCompl":null,
         "cdSerieNfCompl":null,
         "noNfErpCompl":null,
         "infoUpnivel1":[
            {
               "cdUpnivel1":" 20003",
               "deUpnivel1":"TOTVS",
               "cdFornec":7052,
               "fgTpPess":"J",
               "cdIntErp":"1_19_1"
            }
         ],
         "infoFornecs":[
            {
               "cdFornec":7052,
               "deFornec":"TOTVS FORN",
               "fgTpFornec":"2",
               "deTpFornec":"FORNECEDOR",
               "fgTpPess":"F",
               "cdIntErp":"7052"
            }
         ],
         "detalheNfDeOut":[
            {
               "cdUnidInd":1,
               "vlTonCana":7.1066,
               "ddFim":31,
               "vlFatorK":null,
               "noNf":1,
               "vlTotalServ":null,
               "vlRef":null,
               "qCanaEnt":4867980,
               "vlTotal":34594.79,

Bloco de código

language	java
title	Body da Requisição - Notas Fiscais Cana Muda.

{
    "hasNext": false,
    "items": [ {
            "instanciacdSerieNf": "15",
               "fgTpNotavlAcertoAtr": "Cana de Muda Mensal",
null,
               "vlAcAtrReceb":null,
               "noNfinstancia": "1",
               "cdSerieNfdetalheshistTxOut": "1",[
            "cdUnidInd": 1,
     {
        "cdTpProp": 2,
            "cdUpnivel1dtIniPer": "10005B"2018-05-01T00:00:00",
                     "deUpNivel1cdGrpTxContr": "SÃO PEDRO",
1,
                     "deNatOperinstancia": "NOTA CANA MUDA1",
               "cdFiscOp      "cdUnidInd": 11011,
             "cdFornec": 28785,
        "dtFimPer":"2018-05-31T00:00:00",
       "deFornec": "TOTVS SA",
            "cdSafravlTxContrib": 2016449.73,
            "amFornec": "2016-04-01T00:00:00",
            "acPesocdTxContr": 1561361,
            "vlTotNf": 10079.55,
        "txContrib":[
     "dtEmisNf": "2016-04-30T00:00:00",
                  "acTxContrib": 231.83,
 {
              "vlLiqNf": 9847.72,
            "cdTpCalccdTxcontr": null1,
                  "fgComplPreco": null,
            "deObs": null"dtValIni":"2015-10-01T03:00:00.000+00:00",
            "deFiscOp": null,
               "cdClassFiscdeTxcontr": null"INSS",
              "dfSubstituicao": null,
            "vlCredIcmsfpcTxcontr": null1.3,
            "fgAcertoAnual": null,
               "fgManAutocdIndBase": "M"950,
              "dfCpr": null,
            "fgIndividualpcRedBase": null,
              "noContrCana": 1262,
            "cdEmpresafgAcertoAno": "1S",
            "instContr": "1",
               "cdMuniccdTxErp": null,
              "noNfCompl": null,
            "cdSerieNfComplcodigoClassificacao":"CLAS null1",
             "noNfErpCompl": null,
              "detalheNfDeOutcodigoEspecie":"ESPECIE [1"
                 {
       }
             "cdUnidInd": 1,
       ]
              "vlTonCana": 57.38,
   },
                 "ddFim": 30,
 {
                     "vlFatorK": null,
dtIniPer":"2018-05-01T00:00:00",
                     "noNfcdGrpTxContr": 1,
                     "vlTotalServinstancia": null"1",
                     "vlRefcdUnidInd": null1,
                     "qCanaEntdtFimPer": 5073060"2018-05-31T00:00:00",
                     "vlTotalvlTxContrib": 29109269.1819,
                     "cdSerieNfcdTxContr": "1"2,
                     "vlAcertoAtr": null,
txContrib":[
                        {
      "vlAcAtrReceb": null,
                    "instanciacdTxcontr": "1"2,
                     "detalheshistTxOut": [
      "dtValIni":"2015-10-01T03:00:00.000+00:00",
                              {
 "deTxcontr":"SENAR",
                           "dtIniPerpcTxcontr": "2016-04-01T00:00:00"0.2,
                            "cdGrpTxContrcdIndBase": 1950,
                            "instanciapcRedBase": "1"null,
                            "cdUnidIndfgAcertoAno": 1"S",
                            "dtFimPercdTxErp": "2016-04-30T00:00:00"null,
                            "vlTxContribcodigoClassificacao": 6112.94"CLAS 2",
                            "cdTxContrcodigoEspecie":"ESPECIE 12"
                        }
                     ],
                  }
   "vlKgAtr": null,
            ],
               "cdTpCalcvlKgAtr": null,
                    "dataInicialcdTpCalc": 1null,
                    "pcPgVlTondataInicial": null1,
                    "vlBonusTonpcPgVlTon": null,
                },"vlBonusTon":null
               }
            ]
        }
     ]
}

Parâmetros Obrigatórios

...

noNf: Número da Nota Fiscal.
cdSerieNf:Série da Nota Fiscal.
cdUnidInd: Código Unidade Industrial.
fgStatusIntegracao: Flag de busca das integrações. O valor "nulo" refere-se a registros nunca integrados. Exemplo: 1;2;3;nulo;5

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

...

Páginas filhas

Versões comparadas

Versão antiga 13

Nova versão Atual

Chave

Estruturas:

Parâmetros Obrigatórios

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