Árvore de páginas

Versões comparadas

Chave

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

Índice


       

Índice
exclude.*ndice:

Objetivo


       O objetivo deste documento é esclarecer sobre os serviços pagos disponíveis pelo TOTVS API Services e os pré-requisitos para requisição aos mesmos.

Introdução


       O TOTVS API Services é um serviço pago que realiza consultas em entidades públicas e os disponibiliza para qualquer solução TOTVS através de APIs padronizadas, independente do serviço público de consulta. Os serviços disponibilizados são listados abaixo e dependem do mínimo esforço para consumo dos mesmos.


Adesão


       Para que o cliente posso consumir este serviço é necessário que ele possua licença de algum produto TOTVS que suporte a integração com o TOTVS API Services ou que possa ser customizado. A adesão e os planos disponíveis estão disponíveis na TOTVS Store.

Nota
titleAtenção

Consultar a linha de produto pra saber se a mesma possui suporte ao TOTVS API Services


Serviços disponíveis 

Apenas os serviços abaixo estão disponíveis no plano pago, ou seja, os demais serviços do Mashup continuam funcionando normalmente.

     Os serviços disponíveis pelo TOTVS API Services dependem da adesão ao Plano Pago. No entanto existem serviços que são disponibilizados mesmo sem a adesão a um plano, conforme detalhado abaixo.

Serviços disponíveis apenas no Plano Pago


Serviço
Receita Federal - Consulta de CNPJ
Receita Federal - Consulta de CPF
Receita Federal - Consulta de CPF e CNPJ
Receita Federal - Consulta Simples Nacional
Sintegra - Consulta Nacional ao Cadastro
Sintegra - Consulta Unificada ao Cadastro
Suframa - Consulta Situação Fornecedor


Serviços disponíveis sem necessidade de plano



Nota
titleAlteração dos endpoints

Para que não tenhamos quebra nas requisições existente para os serviços acima, as chamadas existentes ao Mashup não serão alteradas. Sendo necessário apenas o envio dos headers conforme descrito no tópico abaixo. 

Nota
titleDemais Serviços

Os demais serviços disponíveis no Mashup continuam com acesso livre, caso tenhamos alterações, a lista acima sofrerá revisão.


Pré-requisitos 


Para que o produto possa consumir estes serviços é necessário o envio das propriedades abaixo no header da requisição.

Abaixo as informações obrigatórias e opcionais enviadas via cabeçalho.

PropriedadeExigência Descrição
totvsmashup-api-keyObrigatório

Após adesão ao plano do TOTVS API Services, é disponibilizado para o cliente uma API KEY. Esta chave deve ser informada ao produto para que a mesma seja enviada em todas requisições realizadas ao Mashup.

 

totvsmashup-product-nameObrigatórioO Produto envia seu nome. Ex.: (RM | PROTHEUS | DATASUL)
totvsmashup-product-moduleObrigatórioO Produto envia seu módulo que está consumindo o serviço do TOTVS API Services. Ex.: (Fopxxxx | SIGAFAT)
totvsmashup-customer-ls-idOpcionalO Produto envia o ID do cliente no License Server;
totvsmashup-product-routineOpcionalO Produto envia sua rotina que está consumindo o serviço do TOTVS API Services. Ex.: (FopFuncAction | mata030)