Histórico da Página
...
Base URL:
ip:porta/api/query/v1/pagtoServicoTerceiroMétodo:
GETConteúdo:
application/jsonPaginação: campo
hasNextno retorno indica se há mais páginas.Autenticação: conforme seu padrão (ex.: OAuth2 do API-Hub TOTVS).
Estruturas:
| Principais campos | |||
| Campo | Tipo | Exemplo | Descrição |
| instancia | string | 1 | Identificador da Instância. |
| dtIniSint | datetime | 2016-03-01T00:00:00 | Data/hora inicial da síntese/período do pagamento. |
| dtFimSint | datetime | 2016-03-31T00:00:00 | Data/hora final da síntese/período do pagamento. |
| cdEmprErp | string | 10 | Código da empresa no ERP. |
| cdUnegErp | string | 100 | Código da unidade de negócio no ERP. |
| cdEvtoErp | string | 18 | Código do evento no ERP. |
| cdEvtoFat | number | 18 | Código do evento de faturamento. |
| fgExpErp | string | N | Flag indicando exportação ao ERP. |
| qtMat | number | 1 | Quantidade de materiais/itens vinculados. |
| cdTranspErp | string | 85340 | Código do transportador no ERP. |
| vlBruto | number | 4824.07 | Valor bruto do pagamento. |
| vlDesconto | number | 0 | Total de descontos aplicados. |
| vlLiquido | number | 4824.07 | Valor líquido após descontos. |
| cdCcustoErp | string | 1_01010802 | Centro de custo no ERP. |
| cdUniEvto | string | HR | Unidade do evento. |
| cdMunicIbge | string | 3501004 | Código do município (IBGE). |
| cdContratoErp | string | 2478 | Código do contrato no ERP. |
| cdContrato | string | 1000000002478 | Código do contrato (negócio). |
| deEvtoFat | string | CARREG.MECÂNICO (HM) | Descrição do evento de faturamento. |
| fgEvtoMunic | string | N | Flag se o evento municipal. |
| cdCcusto | number | 101010802 | Centro de custo. |
| cdMunic | number | 5 | Código do município. |
| cdFornec | number | 319 | Código do fornecedor. |
| Campos internos | |||
| Estrutura | Campos Internos | Exemplo | Descrição |
| cdTransp | cdTransp (number), deTransp (string) | [{'cdTransp': 85340, 'deTransp': 'MAURICIO ...'}] | Dados do prestador. |
| cdUpnivel1 | fazenda (string), cdFornec (number), deUpnivel1 (string), tpPessoa (string), cdIntErp (string) | [{'fazenda':'10455','cdFornec':319,...}] | Unidade produtiva (nível 1) vinculada ao serviço. |
| cdOperacao | cdOperacao (number), deOperacao (string), cdIntErp (string) | [{'cdOperacao':18,'deOperacao':'CARREG. MECÂNICO',...}] | Operação executada (código e descrição). |
| cCusto | cdCcusto (number), deCcustos (string), cdIntErp (string) | [{'cdCcusto':101010802,'deCcustos':'APLIC. TORTA ...'}] | Detalhes do centro de custos. |
| municipio | cdMunic (number), deMunic (string) | [{'cdMunic':5,'deMunic':'ALTINÓPOLIS'}] | Informações do município. |
| Fornecedor | cdFornec (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:
| Campo | Tipo | Obrigatório | Descrição |
| fgStatusIntegracao | String(1) | Sim | Flag do status de integração. |
| instancia | String | Sim | Identificador da instância |
| cdProcesso | Integer | Sim | Código do processo de integração vinculado ao pagamento. |
| dataIniSintet | DateTime | Sim | Data inicial do período sintético do pagamento. |
| dataFimSintet | DateTime | Sim | Data final do período sintético do pagamento. |
| dataPagto | DateTime | Opcional | Data de efetivação do pagamento. |
| dataRetencaoMensal | DateTime | Opcional | Data de retenção mensal do pagamento (quando aplicável). |
| dataRetencaoAnual | DateTime | Opcional | Data 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 | ||||
|---|---|---|---|---|
| ||||
{
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"
} |
...