Manutenção de CSC (Código de Segurança do Contribuinte) na API Rest

Para a emissão de NFC-e, é necessário que seja informado o CSC referente à empresa e estado de emissão. Sem esta informação não é possível obter a autorização do cupom. É possível configurar estas informações na aplicação da Oobj através do monitor e da API. Abaixo instruções sobre como consultar e configurar utilizando as requisições da API da Oobj.

A utilização da API Rest será permitido para o usuário que já possuir o x-auth-token. No artigo Autenticação na API Rest damos mais detalhes sobre o x-auth-token.

 

Adicionar Novo CSC para a Empresa (POST)

Este Endpoint, é utilizado para configurar o CSC de emissão de uma empresa. Caso tenha mais de uma unidade e em estados diferentes é possível configurar todos através desta requisição.

A URL é construída da seguinte forma:

http:// ou https:// + /endereço da API Rest + /api/empresas/{empresa}/cscs/{uf}/{ambiente}

 

Os valores sublinhados devem ser substituídos pelos valores correspondentes abaixo:

  •  {empresa} : CNPJ da Empresa;
  • {uf}: Estado relacionado ao CSC cadastrado na Sefaz;
  • {ambiente}: Ambiente em que o CSC está cadastrado (prod ou hom);

 

Exemplo:

http://rest.oobj-dfe.com.br/api/empresas/07385112358746/cscs/GO/hom

 

Na requisição, deverá ser informado os seguintes dados:

  • Numero Sequencial;
  • Valor do token gerado pela Sefaz;
  • Data de criação do Token junto à Sefaz (Formato UTC [AAAA-MM-DD]);

 

Listar CSC disponível para Empresa (GET)

Este Endpoint, é utilizado para consultar o CSC de emissão disponível para a empresa. Caso tenha mais de uma CSC cadastrado, serão apresentados todos.

A URL é construída da seguinte forma:

http:// ou https:// + /endereço da API Rest + /api/empresas/{empresa}/cscs

 

Os valores sublinhados devem ser substituídos pelos valores correspondentes abaixo:

  •  {empresa} : CNPJ da Empresa;

 

Exemplo:

http://rest.oobj-dfe.com.br/api/empresas/07385112358746/cscs

 

Retornar detalhes do CSC (GET)

Este Endpoint, é utilizado para consultar um CSC de emissão específico de uma empresa.

A URL é construída da seguinte forma:

http:// ou https:// + /endereço da API Rest + /api/empresas/{empresa}/cscs/{uf}/{ambiente}/{sequencial}

 

Os valores sublinhados devem ser substituídos pelos valores correspondentes abaixo:

  •  {empresa} : CNPJ da Empresa;
  • {uf}: Estado relacionado ao CSC cadastrado;
  • {ambiente}: Ambiente em que o CSC está cadastrado (prod ou hom);
  • {sequencial}: Numero sequencial do CSC que deseja consultar;

 

Exemplo:

http://rest.oobj-dfe.com.br/api/empresas/07385112358746/cscs/GO/hom/1

 

Alterar informações do CSC (PUT)

Este Endpoint, é utilizado editar dados do CSC de emissão de uma empresa. 

A URL é construída da seguinte forma:

http:// ou https:// + /endereço da API Rest + /api/empresas/{empresa}/cscs/{uf}/{ambiente}/{sequencial}

 

Os valores sublinhados devem ser substituídos pelos valores correspondentes abaixo:

  •  {empresa} : CNPJ da Empresa;
  • {uf}: Estado relacionado ao CSC cadastrado na Sefaz;
  • {ambiente}: Ambiente em que o CSC está cadastrado (prod ou hom);
  • {sequencial}: Numero sequencial do CSC que deseja editar;

 

Exemplo:

http://rest.oobj-dfe.com.br/api/empresas/07385112358746/cscs/GO/hom/1

 

Na requisição, deverá ser informado os seguintes dados:

  • Valor do token gerado pela Sefaz;
  • Data de criação do Token junto à Sefaz (Formato UTC [AAAA-MM-DD]);

 

Excluir (DELETE)

Este Endpoint, é utilizado excluir os dados de um determinado  CSC de emissão de uma empresa, quando já não é mais utilizado. 

A URL é construída da seguinte forma:

http:// ou https:// + /endereço da API Rest + /api/empresas/{empresa}/cscs/{uf}/{ambiente}/{sequencial}

 

Os valores sublinhados devem ser substituídos pelos valores correspondentes abaixo:

  •  {empresa} : CNPJ da Empresa;
  • {uf}: Estado relacionado ao CSC cadastrado na Sefaz;
  • {ambiente}: Ambiente em que o CSC está cadastrado (prod ou hom);
  • {sequencial}: Numero sequencial do CSC que deseja editar;

 

Exemplo:

http://rest.oobj-dfe.com.br/api/empresas/07385112358746/cscs/GO/hom/1

 

Para realizar testes com a API Rest, e ter mais detalhes sobre a configuração de CSC, acesse a documentação completa através do link: http://rest.oobj-dfe.com.br/swagger-ui.html

0 (0)
Avaliação do Artigo (Nenhum voto)
Avaliar esse artigo
Anexos
Não há anexos para este artigo.
Artigos Relacionados RSS Feed
Configurar MDe na Api Rest
Visualizado 1419 vezes desde 27/09/2018
Emissão de DFes na API Rest
Visualizado 3922 vezes desde 13/03/2018
Integração API Rest
Visualizado 10905 vezes desde 09/03/2018
API REST: Ano contido no documento não é o mesmo do informado no serviço - Como resolver?
Visualizado 1446 vezes desde 08/01/2019
Consultar Base de Conhecimento (BC) via API Rest
Visualizado 245 vezes desde 03/08/2021
Inutilização de Numeração na API Rest
Visualizado 2537 vezes desde 16/03/2018
Emissão de Eventos Fiscais na API Rest
Visualizado 2644 vezes desde 16/03/2018
Configurando Contingência Automática no Monitor da Oobj via API Rest
Visualizado 445 vezes desde 23/08/2021
Recebimento de Documentos Fiscais via API Rest
Visualizado 5185 vezes desde 16/03/2018
Criar Aplicativo no Monitor Oobj
Visualizado 1715 vezes desde 12/04/2018
Comentários
Nome
Email
Código de Segurança Security Code
Não há comentários para este artigo. Seja o primeiro a postar um comentário.