Disponibilizado endpoint para consulta das Notas Fiscais de Entrada de Cana.
Estrutura:
| Atributos | Descrição | Tamanho | Tipo | Observação |
|---|---|---|---|---|
| instancia | Identificador da instância | - | Texto | Obrigatório |
| notaFiscal | Número da nota fiscal | - | Numérico | Obrigatório |
| cdSerieNf | Código da série da nota fiscal | - | Numérico | Obrigatório |
| cdTpProp | Código do tipo de propriedade | - | Numérico | - |
| cdSafra | Ano da safra | 4 | Numérico | - |
| amFornec | Data de fornecimento | - | Data | Formato ISO 8601 |
| acPeso | Peso acumulado | - | Numérico | - |
| vlTotNf | Valor total da nota fiscal | - | Decimal | - |
| dtEmisNf | Data de emissão da nota fiscal | - | Data | Formato ISO 8601 |
| deMunic | Nome do município | - | Texto | - |
| deNatOper | Natureza da operação | - | Texto | - |
| cdFiscOp | Código fiscal da operação | - | Numérico | - |
| deEnd | Endereço | - | Texto | - |
| noCep | CEP | 8 | Texto | - |
| cdUf | Código da unidade federativa | 2 | Texto | - |
| noFone | Telefone | - | Texto | Opcional |
| noCgcCpf | CNPJ/CPF | - | Texto | - |
| fgSituacao | Situação | 1 | Texto | Ex: 'N' |
| acTxContrib | Valor da taxa de contribuição | - | Decimal | - |
| vlLiqNf | Valor líquido da nota fiscal | - | Decimal | - |
| vlLiquida | Valor líquido alternativo | - | Decimal | Opcional |
| cdTpCalc | Código do tipo de cálculo | - | Numérico | - |
| fgComplPreco | Complemento de preço | - | Texto | Opcional |
| fgManAuto | Flag de manutenção automática | 1 | Texto | - |
| fgTipoNotaFiscal | Tipo de nota fiscal | - | Texto | - |
| deObs | Observações | - | Texto | Opcional |
| deFiscOp | Descrição fiscal da operação | - | Texto | Opcional |
| cdClasFisc | Código de classificação fiscal | - | Texto | Opcional |
| fgSubstituicao | Flag de substituição | - | Texto | Opcional |
| vlCredIcms | Valor crédito ICMS | - | Decimal | Opcional |
| fgAcertoAnual | Flag de acerto anual | - | Texto | Opcional |
| fgCpr | Flag CPR | - | Texto | Opcional |
| fgComplProduto | Complemento de produto | - | Texto | Opcional |
| fgIndividual | Flag individual | - | Texto | Opcional |
| noContrCana | Número do contrato de cana | - | Numérico | - |
| cdEmpresa | Código da empresa | - | Texto | - |
| instContr | Instância do contrato | - | Texto | - |
| cdMunic | Código do município | - | Numérico | - |
| cdUsuarioInc | Usuário que incluiu | - | Texto | Opcional |
| dtHrInc | Data/hora inclusão | - | DataHora | Opcional |
| cdUsuarioAlt | Usuário que alterou | - | Texto | Opcional |
| dtHrAlt | Data/hora alteração | - | DataHora | Opcional |
| fluxoCaixa | Descrição do fluxo de caixa | - | Texto | - |
detalheQuinzena
| Atributos | Descrição | Tamanho | Tipo | Observação |
|---|---|---|---|---|
| detalheQuinzena.cdUsuarioInc | Usuário que incluiu | - | Texto | Opcional |
| detalheQuinzena.dtHrAlt | Data/hora alteração | - | DataHora | Opcional |
| detalheQuinzena.vlTonCana | Volume em toneladas de cana | - | Decimal | - |
| detalheQuinzena.dtHrInc | Data/hora inclusão | - | DataHora | Opcional |
| detalheQuinzena.ddFinal | Dia final do período | - | Numérico | - |
| detalheQuinzena.vlFatorK | Fator K | - | Decimal | - |
| detalheQuinzena.vlRef | Valor de referência | - | Decimal | - |
| detalheQuinzena.cdUsuarioAlt | Usuário que alterou | - | Texto | Opcional |
| detalheQuinzena.vlTotal | Valor total | - | Decimal | - |
| detalheQuinzena.vlAcertoAtr | Valor de acerto | - | Decimal | Opcional |
| detalheQuinzena.vlAcAtrReceb | Valor a receber | - | Decimal | - |
| detalheQuinzena.ddInicial | Dia inicial do período | - | Numérico | - |
| detalheQuinzena.cdTpCalc | Tipo de cálculo | - | Numérico | - |
| detalheQuinzena.vlKgAtr | Valor por kg | - | Decimal | - |
| detalheQuinzena.vlAtr | Valor de atr | - | Decimal | - |
| detalheQuinzena.pcPgVlTon | Percentual pago por tonelada | - | Decimal | - |
| detalheQuinzena.qtdeCana | Quantidade de cana | - | Numérico | - |
| detalheQuinzena.vlRetencao | Valor de retenção | - | Decimal | Opcional |
| detalheQuinzena.vlSubsidio | Valor de subsídio | - | Decimal | Opcional |
| detalheQuinzena.vlBonusTon | Bônus por tonelada | - | Decimal | - |
detalheHistTx
| Atributos | Descrição | Tamanho | Tipo | Observação |
|---|---|---|---|---|
| detalheHistTx.instancia | Instância | - | Texto | - |
| detalheHistTx.noNf | Número da nota fiscal | - | Numérico | - |
| detalheHistTx.cdSerieNf | Série da nota fiscal | - | Numérico | - |
| detalheHistTx.cdFornec | Código do fornecedor | - | Numérico | - |
| detalheHistTx.cdUpnivel1 | Código do nível 1 | - | Texto | - |
| detalheHistTx.dtIniPer | Data início período | - | Data | ISO 8601 |
| detalheHistTx.dtFimPer | Data fim período | - | Data | ISO 8601 |
| detalheHistTx.cdTxcontr | Código da taxa | - | Numérico | - |
| detalheHistTx.vlTxContrib | Valor da taxa | - | Decimal | - |
| detalheHistTx.cdGrpTxcontr | Grupo da taxa | - | Numérico | - |
| detalheHistTx.vlBaseTx | Base da taxa | - | Decimal | - |
| detalheHistTx.fgAcertoAnual | Flag acerto anual | - | Texto | Opcional |
| detalheHistTx.fgIndividual | Flag individual | - | Texto | Opcional |
| detalheHistTx.vlSubsidio | Valor de subsídio | - | Decimal | - |
| detalheHistTx.fgLiminarInss | Flag liminar INSS | - | Texto | Opcional |
| detalheHistTx.cdUsuarioAlt | Usuário alteração | - | Texto | Opcional |
| detalheHistTx.dtHrInc | Data/hora inclusão | - | DataHora | Opcional |
| detalheHistTx.dtHrAlt | Data/hora alteração | - | DataHora | Opcional |
| detalheHistTx.cdUsuarioInc | Usuário inclusão | - | Texto | Opcional |
detalheHistTx.infComplTaxa
| Atributos | Descrição | Tamanho | Tipo | Observação |
|---|---|---|---|---|
| detalheHistTx.infComplTaxa.cdTxcontr | Código da taxa | - | Numérico | - |
| detalheHistTx.infComplTaxa.dtValIni | Data início validade | - | Data | - |
| detalheHistTx.infComplTaxa.deTxcontr | Descrição taxa | - | Texto | - |
| detalheHistTx.infComplTaxa.pcTxcontr | Percentual da taxa | - | Decimal | - |
| detalheHistTx.infComplTaxa.cdIndBase | Código indicador base | - | Numérico | - |
| detalheHistTx.infComplTaxa.pcRedBase | Percentual redução base | - | Decimal | Opcional |
| detalheHistTx.infComplTaxa.fgAcertoAno | Flag acerto anual | 1 | Texto | - |
| detalheHistTx.infComplTaxa.cdTxErp | Código ERP | - | Texto | Opcional |
| detalheHistTx.infComplTaxa.codigoClassificacao | Código classificação | - | Texto | - |
| detalheHistTx.infComplTaxa.codigoEspecie | Código espécie | - | Texto | - |
deducoes
| Atributos | Descrição | Tamanho | Tipo | Observação |
|---|---|---|---|---|
| deducoes.instancia | Instância | - | Texto | - |
| deducoes.fgTpProc | Tipo de processo | - | Texto | - |
| deducoes.cdFornec | Código fornecedor | - | Numérico | - |
| deducoes.dtiniPer | Data início período | - | Data | ISO 8601 |
| deducoes.dtFinPer | Data fim período | - | Data | ISO 8601 |
| deducoes.cdEvto | Código do evento | - | Numérico | - |
| deducoes.dtEvto | Data do evento | - | Data | ISO 8601 |
| deducoes.vlDeducao | Valor dedução | - | Decimal | - |
| deducoes.cdGrpEvto | Grupo do evento | - | Numérico | - |
| deducoes.fgIndividual | Flag individual | - | Texto | - |
| deducoes.cdUsuarioInc | Usuário inclusão | - | Texto | - |
| deducoes.dtHrInc | Data/hora inclusão | - | DataHora | - |
| deducoes.cdUsuarioAlt | Usuário alteração | - | Texto | - |
| deducoes.dtHrAlt | Data/hora alteração | - | DataHora | - |
deducoesGtm
| Atributos | Descrição | Tamanho | Tipo | Observação |
|---|---|---|---|---|
| deducoesGtm.instancia | Instância | - | Texto | - |
| deducoesGtm.fgTpProc | Tipo de processo | - | Texto | - |
| deducoesGtm.cdFornec | Código fornecedor | - | Numérico | - |
| deducoesGtm.dtiniPer | Data início período | - | Data | ISO 8601 |
| deducoesGtm.dtFinPer | Data fim período | - | Data | ISO 8601 |
| deducoesGtm.cdEvto | Código evento | - | Numérico | - |
| deducoesGtm.dtEvto | Data do evento | - | Data | ISO 8601 |
| deducoesGtm.vlDeducao | Valor dedução | - | Decimal | - |
| deducoesGtm.cdGrpEvto | Grupo do evento | - | Numérico | - |
| deducoesGtm.fgIndividual | Flag individual | - | Texto | Opcional |
| deducoesGtm.cdUsuarioInc | Usuário inclusão | - | Texto | Opcional |
| deducoesGtm.dtHrInc | Data/hora inclusão | - | DataHora | Opcional |
| deducoesGtm.cdUsuarioAlt | Usuário alteração | - | Texto | Opcional |
| deducoesGtm.dtHrAlt | Data/hora alteração | - | DataHora | Opcional |
infoUpnivel1
| Atributos | Descrição | Tamanho | Tipo | Observação |
|---|---|---|---|---|
| infoUpnivel1.cdUpnivel1 | Código nível 1 | - | Texto | - |
| infoUpnivel1.deUpnivel1 | Descrição nível 1 | - | Texto | - |
| infoUpnivel1.cdFornec | Código fornecedor | - | Numérico | - |
| infoUpnivel1.fgTpPess | Tipo pessoa | 1 | Texto | J = Jurídica, F = Física |
| infoUpnivel1.cdIntErp | Código interno ERP | - | Texto | - |
infoFornecs
| Atributos | Descrição | Tamanho | Tipo | Observação |
|---|---|---|---|---|
| infoFornecs.cdFornec | Código fornecedor | - | Numérico | - |
| infoFornecs.deFornec | Descrição fornecedor | - | Texto | - |
| infoFornecs.fgTpFornec | Tipo fornecedor | - | Texto | 1=Interno, 2=Fornecedor |
| infoFornecs.deTpFornec | Descrição tipo fornecedor | - | Texto | - |
| infoFornecs.fgTpPess | Tipo pessoa | 1 | Texto | J = Jurídica, F = Física |
| infoFornecs.cdIntErp | Código interno ERP | - | Texto | - |
Método GET:
http:127.0.0.1:8080/api/query/v1/notasFiscais
Estrutura de dados:
{
"hasNext":true,
"items":[
{
"instancia":"1",
"notaFiscal":24,
"cdSerieNf":"8",
"cdTpProp":7,
"cdSafra":2016,
"amFornec":"2016-04-01T00:00:00",
"acPeso":384280,
"vlTotNf":23881.35,
"dtEmisNf":"2016-04-30T00:00:00",
"deMunic":"ALTINÓPOLIS",
"deNatOper":"TEST",
"cdFiscOp":1101,
"deEnd":"SITIO:TOTVS,S/N",
"noCep":"14350000",
"cdUf":"SP",
"noFone":null,
"noCgcCpf":"99.999.999/0000-00",
"fgSituacao":"N",
"acTxContrib":358.22,
"vlLiqNf":23523.13,
"vlLiquida":null,
"cdTpCalc":99,
"fgComplPreco":null,
"fgManAuto":"A",
"fgTipoNotaFiscal":"Mensal Automático",
"deObs":null,
"deFiscOp":null,
"cdClasFisc":null,
"fgSubstituicao":null,
"vlCredIcms":null,
"fgAcertoAnual":null,
"fgCpr":null,
"fgComplProduto":null,
"fgIndividual":null,
"noContrCana":1729,
"cdEmpresa":"1",
"instContr":"1",
"cdMunic":5,
"cdUsuarioInc":null,
"dtHrInc":null,
"cdUsuarioAlt":null,
"dtHrAlt":null,
"fluxoCaixa":"RCMP - FLXCX - NF",
"detalheQuinzena":[
{
"cdUsuarioInc":null,
"dtHrAlt":null,
"vlTonCana":62.1457,
"dtHrInc":null,
"ddFinal":30,
"vlFatorK":1,
"vlRef":0,
"cdUsuarioAlt":null,
"vlTotal":23881.35,
"vlAcertoAtr":null,
"vlAcAtrReceb":0,
"ddInicial":16,
"cdTpCalc":99,
"vlKgAtr":0.5881,
"vlAtr":132.09,
"pcPgVlTon":80,
"qtdeCana":384280,
"vlRetencao":null,
"vlSubsidio":null,
"vlBonusTon":0
}
],
"detalheHistTx":[
{
"instancia":"1",
"noNf":24,
"cdSerieNf":"8",
"cdFornec":50774,
"cdUpnivel1":" 20526",
"dtIniPer":"2016-04-01T00:00:00",
"dtFimPer":"2016-04-30T00:00:00",
"cdTxcontr":1,
"vlTxContrib":310.46,
"cdGrpTxcontr":1,
"vlBaseTx":23881.35,
"fgAcertoAnual":null,
"fgIndividual":null,
"vlSubsidio":0,
"fgLiminarInss":null,
"cdUsuarioAlt":null,
"dtHrInc":null,
"dtHrAlt":null,
"cdUsuarioInc":null,
"infComplTaxa":{
"cdTxcontr":1,
"dtValIni":"2015-10-01T00:00:00",
"deTxcontr":"INSS",
"pcTxcontr":1.3,
"cdIndBase":950,
"pcRedBase":null,
"fgAcertoAno":"S",
"cdTxErp":null,
"codigoClassificacao":"CLAS 1",
"codigoEspecie":"ESPECIE 1"
}
},
{
"instancia":"1",
"noNf":24,
"cdSerieNf":"8",
"cdFornec":50774,
"cdUpnivel1":" 20526",
"dtIniPer":"2016-04-01T00:00:00",
"dtFimPer":"2016-04-30T00:00:00",
"cdTxcontr":2,
"vlTxContrib":47.76,
"cdGrpTxcontr":1,
"vlBaseTx":23881.35,
"fgAcertoAnual":null,
"fgIndividual":null,
"vlSubsidio":0,
"fgLiminarInss":null,
"cdUsuarioAlt":null,
"dtHrInc":null,
"dtHrAlt":null,
"cdUsuarioInc":null,
"infComplTaxa":{
"cdTxcontr":2,
"dtValIni":"2015-10-01T00:00:00",
"deTxcontr":"SENAR",
"pcTxcontr":0.2,
"cdIndBase":950,
"pcRedBase":null,
"fgAcertoAno":"S",
"cdTxErp":null,
"codigoClassificacao":"CLAS 2",
"codigoEspecie":"ESPECIE 2"
}
}
],
"deducoes":[
{
"instancia":"1",
"fgTpProc":"Nota Mensal",
"cdFornec":50774,
"dtiniPer":"2016-04-01T00:00:00",
"dtFinPer":"2016-04-30T00:00:00",
"cdEvto":162,
"dtEvto":"2016-04-01T00:00:00",
"vlDeducao":150,
"cdGrpEvto":2,
"fgIndividual":"S",
"cdUsuarioInc":"TOTVS",
"dtHrInc":"2024-08-06T03:00:00",
"cdUsuarioAlt":"XXX",
"dtHrAlt":"2024-08-07T21:00:00"
}
],
"deducoesGtm":[
{
"instancia":"1",
"fgTpProc":"Nota Mensal",
"cdFornec":50774,
"dtiniPer":"2016-04-01T00:00:00",
"dtFinPer":"2016-04-30T00:00:00",
"cdEvto":110,
"dtEvto":"2016-11-30T00:00:00",
"vlDeducao":78349.97,
"cdGrpEvto":1,
"fgIndividual":null,
"cdUsuarioInc":null,
"dtHrInc":null,
"cdUsuarioAlt":null,
"dtHrAlt":null
}
],
"infoUpnivel1":[
{
"cdUpnivel1":" 20526",
"deUpnivel1":"TOTVS",
"cdFornec":50774,
"fgTpPess":"J",
"cdIntErp":"1_1133_4"
}
],
"infoFornecs":[
{
"cdFornec":50774,
"deFornec":"TOTVS FAZ",
"fgTpFornec":"2",
"deTpFornec": "FORNECEDOR",
"fgTpPess":"F",
"cdIntErp":"50774"
}
]
}
]
} |
Disponibilizado endpoint para atualizar status de integração dos registros relacionados as Notas fiscais de entrada de cana - Mensal.
Método PUT:
http:127.0.0.1:8080/query/v1/notasFiscais
{
"fgStatusERP": "S",
"instancia": 31,
"notaFiscal": 49,
"cdSerieNf": "8",
"fgTipoNotaFiscal": "M"
} |
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, 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 NFs de entrada de cana":
Para mais detalhes sobre a funcionalidade citada acima, acesse a página Cadastro de Bloqueio de Movimentações via API. |