CONTEÚDO
Índice |
---|
minLevel | 2 |
---|
exclude | CONTEÚDO |
---|
style | none |
---|
|
01. Inserir
dev-fiscal-motor-registrando-ewqor2fuqq-uc.a.run.app/fiscal-motor-registrandoCorpo jsonenvio): | { "codigoExterno": " |
ATOR008 "ativo": trueAtor01001", "tipoAtor": "PESSOA_JURIDICA", "documento": "12345678912345", "nomeFantasia": "EMPRESA S.A.", "razaoSocial": "EMPRESA S.A.", "nome": null, "ativo": true, "inscricaoEstadual": 4566789, "inscricaoMunicipal": 1234586, "contribuinteIcms": false, "ramoAtividade": |
"CT-E EMITIDO EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL", "razaoSocial": "CT-E EMITIDO EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL", "nome": null,"COMERCIAL", "numDependentes": 2, "regimeTributario": "REGIME_NORMAL", "enderecos": [ { "paisId": 1, "paisNome": "Brasil", "estadoId": 26, "estadoNome": "São Paulo", "estadoUf": "SP", "cidadeId": 5270, "cidadeNome": "São Paulo", "bairro": "Jardim das Pedras", "cepZipCode": "05215458", "logradouro": "Rua Afonso Pena", "numero": "55A", "complemento": "Conjunto 2", "principal": true, "email": "contato@totvs.com.br", "telefone": "999999999" } ], "cnaes": [ { "id": "0c276bea-e138-a157-eb76-0011bddd4126", "principal": true }, { "id": "bc4791b2-ef13-84aa-20b0-4c92f0f23ae6", "principal": false } ] } |
Status de retorno: (HTTP - Status Code) | - 201 - Created (Criado)
- 400 - Bad Request (Um ou mais campos estão inválidos. Faça o preenchimento correto e tente novamente)
- 401 - Unauthorized (Falha na autenticação)
- 500 - Internal Error (Falha de comunicação com a fila: fiscal-motor-starting-calculating-topic ou Dados mínimos precisam ser preenchidos)
|
Modelo JSON (retorno) quando retorna status 201: | { "id": "abdfdcf5-80a5-4289-9144-318bd405365b", "codigo": "Ator01001", "tipoAtor": "PESSOA_JURIDICA", "documento": "12345678912345", "nomeFantasia": "EMPRESA S.A.", "razaoSocial": "EMPRESA S.A.", "ativo": true, "codigoExterno": "Ator01001", "contribuinteIcms": false |
nullcontribuinteIcms false 1234586, "enderecos": [ { "paisId": |
1 24 4549 5270, "bairro": "Jardim das Pedras", "cepZipCode": "05215458", "logradouro": "Rua Afonso Pena", "numero": "55A", "complemento": " |
Conjuto 2Conjunto 2", "principal": |
truecontato@totvscontato@totvs.com.br", "telefone": "999999999" } ], "ramoAtividade": "COMERCIAL", "regimeTributario": "REGIME_NORMAL", "numDependentes": 2, "cnaes": [ { "id": " |
95192310508f3ece-77d0-e11965cd45a8eb76-0011bddd4126", "codigo": "0111-3/03", "descricao": "Cultivo De Trigo", "principal": |
trueaa13d02e6943186b-a973-453324f123a120b0-4c92f0f23ae6", "codigo": "01.12-1", "descricao": "Cultivo De Algodão Herbáceo E De Outras Fibras De Lavoura Temporária", "principal": |
falseStatus de retorno: (HTTP - Status Code) | 201 - Created Atributo | Detalhes |
---|
codigoExterno |
|
nomeFantasia | Informar apenas quando se tratar de ator PESSOA_JURIDICA. |
razaoSocial | Informar apenas quando se tratar de ator PESSOA_JURIDICA. |
nome | Informar apenas quando se tratar de ator PESSOA_FISICA ou ESTRANGEIRO. |
tipoAtor | Os valores permitidos para esse campo são: - PESSOA_JURIDICA - Quando é uma entidade (empresa, sociedade, organização etc) e o documento é CNPJ.
- PESSOA_FISICA - Quando é uma pessoa, individuo e o documento é um CPF.
- ESTRANGEIRO - Quando é uma pessoa de outro país.
|
documento | Preenchido com CNPJ quando for PESSOA_JURIDICA ou com CPF quando for PESSOA_FISICA. |
inscricaoEstadual |
|
bairro |
|
cepZipCode |
|
cidade | Os atributos permitidos são: - "cidadeId" - Informar quando for o id interno da cidade. Exemplo: "cidadeId": 5270
- "cidadeNome" - Informar quando for o nome da cidade. O Nome da cidade deve ser preenchido exatamente como está cadastrado no IBGE. Exemplo:"cidadeNome": São Paulo
Aviso |
---|
Caso seja informado a "cidadeId", não deve informar a "cidadeNome" e vice-versa |
|
complemento |
|
estado | Os atributos permitidos são: - "estadoId" - Informar quando for o id interno do país. Exemplo: "estadoId": 26
- "estadoNome" - Informar quando for o nome do estado. O Nome do estado deve ser preenchido exatamente como está cadastrado no IBGE.
- "estadoUf" - Informar Sigla UF do estado.
Exemplo:"estadoNome": São Paulo Exemplo: "estadoUf":"SP" Aviso |
---|
Caso seja informado o "estadoId", não deve informar o "estadoNome" e "estadoUf" e vice-versa Enviar apenas um dos atributos. |
|
logradouro |
|
numero |
|
pais | Os atributos permitidos são: - "paisId" - Informar quando for o id interno do país. Exemplo: "paisId": 1
- "paisNome" - Informar quando for o nome do país. Exemplo:"paisId": Brasil
Aviso |
---|
Caso seja informado o "paisId", não deve informar o "paisNome" e vice-versa |
|
|
|
02. Atualizar
Endpoint: | Ambiente Stage: https:// |
dev-fiscal-motor-registrando-ewqor2fuqq-uc.a.run.app/fiscal-motor-registrandostg.motorfiscal.raas.varejo.totvs.com.br/registering/api/v1/ator/{id} |
Método: | PUT |
Descrição: | Utilize este recurso para atualizar os dados de um registro já cadastrado. |
Parâmetro: | Id: valor utilizado para encontrar o registro que será alterado com os dados do corpo da requisição. |
Corpo jsonenvio): | { "codigoExterno": "ATOR008", "tipoAtor": "PESSOA_JURIDICA", "documento": "123456789123459", "nomeFantasia": " |
CT-E EMITIDO EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCALEMPRESA S.A.", "razaoSocial": " |
CT-E EMITIDO EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL null true true, "inscricaoEstadual": 4566789, "inscricaoMunicipal": |
null 1234586, "contribuinteIcms": false, " |
: falsenumDependentes": 1, "regimeTributario": "SIMPLES_NACIONAL", "enderecos": [ { "paisId": 1, "paisNome": |
1": 24": 24, "estadoNome": "São Paulo", "estadoUf": "SP", "cidadeId": |
4549 4549, "cidadeNome": "São Paulo", "bairro": "Jardim das Pedras", "cepZipCode": "05215458", "logradouro": "Rua Afonso Pena", "numero": "55A", "complemento": "Conjuto 2", "principal": |
truecontato@totvscontato@totvs.com.br", "telefone": "9988887777" } ], "ramoAtividade": "COMERCIAL", "cnaes": [ { "id": "95192310-508f-3ece-77d0-e11965cd45a8", "principal": |
true true }, { "id": "aa13d02e-6943-186b-a973-453324f123a1", "principal": |
false false } ] } |
Status de retorno: (HTTP - Status Code) | 200 - OK |
Observações: | As observações citadas na inclusão também se aplicam na alteração. |
03. Excluir
dev-fiscal-motor-registrando-ewqor2fuqq-uc.a.run.app/fiscal-motor-registrando 04.
...
Consultar Registro Específico
dev-fiscal-motor-registrando-ewqor2fuqq-uc.a.run.app/fiscal-motor-registrandoRetorno json: | { "id": "99701d8d-c888-441e-9569-692123053aab", "codigo": "ATOR008", "tipoAtor": "PESSOA_JURIDICA", "documento": "999999999", "nomeFantasia": " |
CT-E EMITIDO EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCALEMPRESA S.A.", "razaoSocial": " |
CT-E EMITIDO EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL null true true, "codigoExterno": "ATOR008", "inscricaoEstadual": 4566789, "inscricaoMunicipal": |
null 1234586, "contribuinteIcms": |
false false, "numDependentes": 1, "regimeTributario": "SIMPLES_NACIONAL", "enderecos": [ { "paisId": |
1 1, "paisNome": "Brasil", "estadoId": |
24 24, "estadoUf": "SC", "estadoCodIbge": |
42 42, "estadoNome": "Santa Catarina", "cidadeId": |
4549 4209102 4209102, "cidadeNome": "Joinville", "bairro": "Jardim das Pedras", "cepZipCode": "05215458", "logradouro": "Rua Afonso Pena", "numero": "55A", "complemento": "Conjuto 2", "principal": |
truecontato@totvscontato@totvs.com.br", "telefone": "9988887777" } ], "ramoAtividade": "COMERCIAL", "cnaes": [ { "id": "95192310-508f-3ece-77d0-e11965cd45a8", "codigo": "0119-9/01", "descricao": "Cultivo De Abacaxi" "principal": "true" }, { "id": "aa13d02e-6943-186b-a973-453324f123a1", "codigo": "0721-9/01", "descricao": "Extração De Minério De Alumínio" "principal": "false" } ] } |
Status de retorno: (HTTP - Status Code) | 200 - OK |
05. Consultar
Endpoint: | Ambiente Stage: https:// |
dev-fiscal-motor-registrando-ewqor2fuqq-uc.a.run.app/fiscal-motor-registrandostg.motorfiscal.raas.varejo.totvs.com.br/registering/api/v1/ator/filtros |
Método: | GET |
Descrição: | Utilize este recurso para detalhar os dados de um registro. |
FiltrospesquisarFiltros: - tipoAtor: tipo do ator (PESSOA_FISICA, PESSOA_JURIDICA, ESTRANGEIRO)
- documento: numero do documento fiscal do ator (CNPJ, CPF, ID ESTRANGEIRO)
- nomeFantasia: nome do ator (preenchido quando for do tipo pessoa jurídica)
- razaoSocial: nome jurídico do ator (preenchido quando for do tipo pessoa jurídica)
- nome: nome do ator (preenchido quando for do tipo pessoa física)
- codigoExterno: código utilizado para identificação do ator.
|
Retorno json: | { "content": [ { "id": "99701d8d-c888-441e-9569-692123053aab", "codigo": "ATOR008", "tipoAtor": "PESSOA_JURIDICA", "documento": "1234567891234599", "nomeFantasia": " |
CT-E EMITIDO EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCALEMPRESA S.A.", "razaoSocial": " |
CT-E EMITIDO EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL null true true, "codigoExterno": "ATOR008",
|
"inscricaoEstadual": null "inscricaoEstadual": 4566789, "inscricaoMunicipal": 1234586, "contribuinteIcms": |
false false, "enderecos": [ { "paisId": |
1 1, "paisNome": "Brasil", "estadoId": |
24 24, "estadoUf": "SC", "estadoCodIbge": |
42 42, "estadoNome": "Santa Catarina", "cidadeId": |
4549 4209102 4209102, "cidadeNome": "Joinville", "bairro": "Jardim das Pedras", "cepZipCode": "05215458", "logradouro": "Rua Afonso Pena", "numero": "55A", "complemento": "Conjuto 2", "principal": |
truecontato@totvscontato@totvs.com.br", "telefone": "12345678912345" } ], "ramoAtividade": "COMERCIAL", "numDependentes": 2, "regimeTributario": "REGIME_NORMAL", "cnaes": [ { "id": "95192310-508f-3ece-77d0-e11965cd45a8", "codigo": "0119-9/01", "descricao": "Cultivo De Abacaxi"
"principal": "true" }, { "id": "aa13d02e-6943-186b-a973-453324f123a1", "codigo": "0721-9/01", "descricao": "Extração De Minério De Alumínio"
"principal": "false" } ] } ], "pageable": { "sort": { "sorted":
|
false true true 0 20 0 false true true 1 1, "totalElements": 1, "numberOfElements": 1, "first": |
true 20 0 false true true false false } |
Status de retorno: (HTTP - Status Code) | 200 - OK |