Como vincular um novo CSC a uma empresa?

Neste artigo você encontra o passo a passo para configurar o CSC de emissão de uma empresa.

ATENÇÃO

Caso a empresa tenha filiais em estados diferentes, repita o procedimento abaixo individualmente para cada um dos estados.

---

Vincular um novo CSC

1. Para começar, faça uma requisição tipo POST ao endpoint de vincular um novo CSC;

   [URL_BASE]/api/empresas/{empresa}/cscs/{uf}/{ambiente}

2. Preencha as seguintes informações (path parameters):

• {empresa}*: CNPJ (onze caracteres) ou CPF (oito caracteres), sem pontos nem traços;
• {uf}*: sigla da UF. Valores aceitos: AC, AL, AP, AM, BA, CE, DF, ES, GO, MA, MT, MS, MG, PA, PB, PR, PE, PI, RJ, RN, RS, RO, RR, SC, SP, SE ou TO;
• {ambiente}*: hom ou prod.

3. Preencha os parâmetros de consulta (query parameters):

• {sequencial}*: número que identifica a versão do CSC.
• {token}*: código de segurança do consumidor gerado pela Sefaz;
• {dataCriacao}opcional: Data de criação do token pela Sefaz no formato UTC [AAAA-MM-DD].

4. Informe o x-auth-token no cabeçalho (header parameters) da requisição.

Exemplo de requisição

O exemplo abaixo traz um modelo de requisição preenchido para vincular um CSC a um CNPJ.

Observação

A requisição contém dados fictícios, somente para demonstração.

curl -L -X POST 'https://rest-teste.oobj.com.br/api/empresas/07385111000102/cscs/GO/hom?sequencial=8&token=3PWX3KGA-KO8I-BPFN-1GD1-4VHOUXKZTWGYB&dataCriacao=2023-04-24' \
-H 'Accept: application/json;charset=UTF-8' \
-H 'x-auth-token: eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiI3Yjc2OTg1ZGQ2MTNhOWVlYTFiN2RmZTNiZjRhMTRiZiIsImF1ZCI6IndlYiIsImV4cCI6MTYyOTI5MDcwNiwiaWF0IjoxNjI5Mjg4OTA2fQ.-Dj91d6fBZYcZpy1-zKzohAWd5dgW2CAS5BBfwGilemUYcOVDm8CnrDJHbwsFyixI5ohphy-65fqeobXkimtCg'

Exemplo de retorno

{
    "uf": "GO",
    "sequencial": 8,
    "token": "3PWX3KGA-KO8I-BPFN-1GD1-4VHOUXKZTWGYB",
    "validade": "2024-04-24 03:00:00",
    "ambiente": 2
}

Pronto! Você acaba de completar a vinculação de um CSC a uma empresa.