Páginas filhas
  • API Pagamento de Serviços de Terceiro

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

  • Base URL: ip:porta/api/query/v1/pagtoServicoTerceiro

  • Método: GET

  • Conteúdo: application/json

  • Paginação: campo hasNext no retorno indica se há mais páginas.

  • Autenticação: conforme seu padrão (ex.: OAuth2 do API-Hub TOTVS).


Estruturas:

Principais campos
CampoTipoExemploDescrição
instanciastring1Identificador da Instância.
dtIniSintdatetime2016-03-01T00:00:00Data/hora inicial da síntese/período do pagamento.
dtFimSintdatetime2016-03-31T00:00:00Data/hora final da síntese/período do pagamento.
cdEmprErpstring10Código da empresa no ERP.
cdUnegErpstring100Código da unidade de negócio no ERP.
cdEvtoErpstring18Código do evento no ERP.
cdEvtoFatnumber18Código do evento de faturamento.
fgExpErpstringNFlag indicando exportação ao ERP.
qtMatnumber1Quantidade de materiais/itens vinculados.
cdTranspErpstring85340Código do transportador no ERP.
vlBrutonumber4824.07Valor bruto do pagamento.
vlDescontonumber0Total de descontos aplicados.
vlLiquidonumber4824.07Valor líquido após descontos.
cdCcustoErpstring1_01010802Centro de custo no ERP.
cdUniEvtostringHRUnidade do evento.
cdMunicIbgestring3501004Código do município (IBGE).
cdContratoErpstring2478Código do contrato no ERP.
cdContratostring1000000002478Código do contrato (negócio).
deEvtoFatstringCARREG.MECÂNICO (HM)Descrição do evento de faturamento.
fgEvtoMunicstringNFlag se o evento municipal.
cdCcustonumber101010802Centro de custo.
cdMunicnumber5Código do município.
cdFornecnumber319Código do fornecedor.
Campos internos
EstruturaCampos InternosExemploDescrição
cdTranspcdTransp (number), deTransp (string)[{'cdTransp': 85340, 'deTransp': 'MAURICIO ...'}]Dados do prestador.
cdUpnivel1fazenda (string), cdFornec (number), deUpnivel1 (string), tpPessoa (string), cdIntErp (string)[{'fazenda':'10455','cdFornec':319,...}]Unidade produtiva (nível 1) vinculada ao serviço.
cdOperacaocdOperacao (number), deOperacao (string), cdIntErp (string)[{'cdOperacao':18,'deOperacao':'CARREG. MECÂNICO',...}]Operação executada (código e descrição).
cCustocdCcusto (number), deCcustos (string), cdIntErp (string)[{'cdCcusto':101010802,'deCcustos':'APLIC. TORTA ...'}]Detalhes do centro de custos.
municipiocdMunic (number), deMunic (string)[{'cdMunic':5,'deMunic':'ALTINÓPOLIS'}]Informações do município.
FornecedorcdFornec (number), deFornec (string), cdIntErp (string), fgTpFornecs (string), cdTrans (number|null), fgAtivo (string)[{'cdFornec':319,'deFornec':'FORNECEDOR TOTVS 2',...}]

Dados do fornecedor.


Método GET:

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

...

  • cdContrato (string) – Código do contrato.

  • cdFornec (number) – Código do fornecedor.

  • cdTransp (number) – Código do transportador (prestador).


Atualizar status de integração - Pagamento de Serviços (Prestadores/Terceiros)

Disponibilizado endpoint para atualização do status de integração dos registros de Pagamento de Serviços (Prestadores/Terceiros), considerando o retorno do processamento de integração e as regras de bloqueio de reversões definidas no módulo Bioenergia.


Estrutura:

CampoTipoObrigatórioDescrição
fgStatusIntegracaoString(1)SimFlag do status de integração.
instanciaStringSimIdentificador da instância
cdProcessoIntegerSimCódigo do processo de integração vinculado ao pagamento.
dataIniSintetDateTimeSimData inicial do período sintético do pagamento.
dataFimSintetDateTimeSimData final do período sintético do pagamento.
dataPagtoDateTimeOpcionalData de efetivação do pagamento.
dataRetencaoMensalDateTimeOpcionalData de retenção mensal do pagamento (quando aplicável).
dataRetencaoAnualDateTimeOpcionalData de retenção anual do pagamento (quando aplicável).


Método PUT:

http:127.0.0.1:8080/api/entity/v1/pagamentoServico

...

Bloco de código
languagejava
titleRequest
 {              
 	fgStatusIntegracao": "S1",
  	"instancia": "1",
  	"cdProcesso": 1,
  	"dataIniSintet": "2016-06-01T00:00:00",
  	"dataFimSintet": "2016-06-30T00:00:00",
  	"dataPagto": "2016-07-11T00:00:00",
  	"dataRetencaoMensal": "2016-07-11T00:00:00",
  	"dataRetencaoAnual": "2016-07-11T00:00:00"
}

...