TOTVS AGRO

Páginas filhas
  • API Movimentos de Acerto Anual e Final de Safra

Contexto Geral

A presente API destina-se para a consulta de Acerto Anual e Final de Safra, permitindo obter informações consolidadas sobre ajustes financeiros e/ou contratuais relacionados ao ciclo da safra, garantindo transparência, rastreabilidade e apoio à gestão de contratos de matéria-prima.


Estrutura:

AtributoDescriçãoTipoObservação
instanciaIdentificador da instânciaNuméricoIdentifica a instância do processo
amAcertoMês/ano do acertoDataEx: “2018-09-01T00:00:00”
fgTpProcTipo de processoTextoEx: “9”
pcAcertoPercentual de acertoNuméricoEx: 100
dtBaseAtrData base ATRDataEx: “2018-09-30T00:00:00”
cdSafraCódigo da safraNuméricoEx: 2018
vlAtrValor ATR (kg ATR)NuméricoEx: 136.92
vlTonCanaValor por tonelada de canaNuméricoEx: 74.78
qtCanaEntQuantidade de cana entregueNuméricoEx: 33341816
vlCanaBrutoValor bruto da canaNuméricoEx: 2610359.32
vlCanaLiqValor líquido da canaNuméricoEx: 2610359.32
vlFatorkValor do fator KNuméricoEx: 1
vlPg100Valor pago 100%NuméricoPode ser nulo
vlAcertoAtrValor do acerto ATRNuméricoPode ser nulo
vlTotServValor total de serviçosNuméricoPode ser nulo
fgAcertoFinalFlag de acerto finalTexto“S” ou “N”
fgIndividualFlag de cálculo individualTexto“S” ou “N”
vlAcAtrRecebValor ATR recebidoNuméricoEx: 0
vlKgAtrValor por Kg ATRNuméricoEx: 0.5718
vlTotBonusValor total de bônusNuméricoPode ser nulo
vlRecPgTotValor total recebido/pagoNuméricoPode ser nulo
fatorReducaoFator de redução aplicadoNuméricoPode ser nulo
acTotNfAcúmulo total de notas fiscaisNuméricoPode ser nulo
vlTotServCorrValor total de serviços corrigidoNuméricoPode ser nulo
fgCalcAcertoTipo de cálculo de acertoTextoEx: “A”
fgAcertoAnualFlag de acerto anualTexto“S” ou “N”
fgContrRescindFlag contrato rescindidoTextoPode ser nulo
instContrInstância do contratoNuméricoEx: “1”
cdEmpContrCódigo da empresa do contratoNuméricoEx: “1”
noContrCanaNúmero do contrato de canaNuméricoEx: 2552
vlRefAnoValor referência anualNuméricoPode ser nulo
vlIcmsValor ICMSNuméricoEx: 0
vlDescGeocanaValor desconto GeocanaNuméricoPode ser nulo
qtAtrSemPremioQuantidade ATR sem prêmioNuméricoPode ser nulo

infoUpnivel1.cdUpnivel1Código unidade nível 1TextoEx: “10002”
infoUpnivel1.deUpnivel1Descrição unidade nível 1TextoEx: “FAZENDA TOTVS 10002”
infoUpnivel1.cdFornecCódigo do fornecedorNuméricoEx: 319
infoUpnivel1.fgTpPessTipo de pessoaTexto“J” (Jurídica)
infoUpnivel1.cdIntErpCódigo de integração ERPTextoEx: “1_600_2”

infoFornecs.cdFornecCódigo do fornecedorNuméricoEx: 319
infoFornecs.deFornecNome do fornecedorTextoEx: “FORNECEDOR TOTVS 2”
infoFornecs.fgTpFornecTipo do fornecedorTextoEx: “4”
infoFornecs.deTpFornecDescrição tipo fornecedorTexto

1 - ACIONISTA

2 - FORNECEDOR

3 - EVENTUAL

4 - PROPRIO

5 - PARCEIRO

infoFornecs.fgTpPessTipo de pessoaTexto“J”
infoFornecs.cdIntErpCódigo de integração ERPTextoEx: “319”

tipoPropriedade.cdTpProprCódigo do tipo de propriedadeNuméricoEx: 1
tipoPropriedade.deTpProprDescrição do tipo de propriedadeTextoEx: “PRÓPRIA”

tipoCalculo.cdTpCalcCódigo do tipo de cálculoNuméricoEx: 99
tipoCalculo.deTpCalcDescrição do tipo de cálculoTextoEx: “CONSECANA”

unidadeIndustrial.cdUnidIndCódigo da unidade industrialNuméricoEx: 1
unidadeIndustrial.deUnidIndDescrição da unidade industrialTextoEx: “USINA TOTVS 01”


Método GET:

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

Response
{
   "hasNext":true,
   "items":[
      {
         "instancia":"1",
         "amAcerto":"2018-09-01T00:00:00",
         "fgTpProc":"9",
         "pcAcerto":100,
         "dtBaseAtr":"2018-09-30T00:00:00",
         "cdSafra":2018,
         "vlAtr":136.92,
         "vlTonCana":74.78,
         "qtCanaEnt":33341816,
         "vlCanaBruto":2610359.32,
         "vlCanaLiq":2610359.32,
         "vlFatork":1,
         "vlPg100":null,
         "vlAcertoAtr":null,
         "vlTotServ":null,
         "fgAcertoFinal":"N",
         "fgIndividual":"N",
         "vlAcAtrReceb":0,
         "vlKgAtr":0.5718,
         "vlTotBonus":null,
         "vlRecPgTot":null,
         "fatorReducao":null,
         "acTotNf":null,
         "vlTotServCorr":null,
         "fgCalcAcerto":"A",
         "fgAcertoAnual":"N",
         "fgContrRescind":null,
         "instContr":"1",
         "cdEmpContr":"1",
         "noContrCana":2552,
         "vlRefAno":null,
         "vlIcms":0,
         "vlDescGeocana":null,
         "qtAtrSemPremio":null,
         "infoUpnivel1":[
            {
               "cdUpnivel1":" 10002",
               "deUpnivel1":"FAZENDA TOTVS  10002",
               "cdFornec":319,
               "fgTpPess":"J",
               "cdIntErp":"1_600_2"
            }
         ],
         "infoFornecs":[
            {
               "cdFornec":319,
               "deFornec":"FORNECEDOR TOTVS 2",
               "fgTpFornec":"4",
               "deTpFornec":"PROPRIO",
               "fgTpPess":"J",
               "cdIntErp":"319"
            }
         ],
         "tipoPropriedade":[
            {
               "cdTpPropr":1,
               "deTpPropr":"PROPRIA"
            }
         ],
         "tipoCalculo":[
            {
               "cdTpCalc":99,
               "deTpCalc":"CONSECANA"
            }
         ],
         "unidadeIndustrial":[
            {
               "cdUnidInd":1,
               "deUnidInd":"USINA TOTVS 01"
            }
         ]
      }
   ]
}


Parâmetros Obrigatórios

  • instancia: Código da Instância.
  • amAcerto: Data de Acerto.


Parâmetros Opcionais

  • cdUnidInd: Código da Unidade Industrial.
  • cdUpnivel1: Código de Fazenda.
  • fgTpProc: .
  • Sem rótulos