Árvore de páginas

Versões comparadas

Chave

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

Objetivo

Realizar a inclusão do NCM.de Pessoa.

Atenção antes de realizar um cadastro de pessoa através da API é necessário que o endereço completo esteja cadastrado, ou seja, cidade, bairro, logradouro devem estar previamente cadastrados no banco. 

Chamada

POST [URLAPI]/CadastrosEstruturaisAPI/api/v1/Ncm/Pessoa

Permissionamento

Antes de prosseguir, certifique-se de que o usuário, utilizado para autenticação de uso na API, está com as devidas permissões no Sistema/Módulo/Aplicações e na empresa desejada.

Para isso, acesse o módulo SegurançaWeb > Permissões > Associação de Permissão Usuário / Grupo >  Sistemas/Módulo/Aplicações > Comercial Web > API Cadastros Estruturais > API Cadastros Estruturais 


Image Added

Imagem 01 - Configurações de Sistemas/Módulos/Aplicações

Assuntos Relacionados

Para saber mais sobre permissionamentos acesse Permissões - Segurança Web.

Informações para Requisição (Request Information)

...

Código do NCMdescricaoDescrição do NCMdescReduzidaDescrição reduzida NCMString

Nome (Name)

Descrição (Description)

Tipo (Type)

Informações Adicionais (Adittional Information))

VersaoVersão da pessoaInteger($int64)Não há
NomeRazaoSocialRazão SocialStringObrigatório.
FantasiaNome fantasiaStringNão há
TipoFísica ou Jurídica  (Opções: F - Física / J - Jurídica)StringValores permitidos FJ ou nulo.
SexoSexo (Opções: M - Masculino / F - Feminino)StringNão há
StatusStatus da pessoa (Opções: A - Ativo / I - Inativo / P - Prospect / O - Outros) StringObrigatório, valores permitidos AI, P, O.
NomeCidadeNome da cidadeStringSerá usado o menor Identificador(SEQCIDADE), caso hajam cidades com nomes iguais na mesma UF.
UFCidadeEstadocodNcmStringNão há
PaisCidadePaísStringNão há
CodigoMunicipioCódigo do municípioInteger($int64)Não há
CodigoPaisCódigo do país.Integer($int64perImpostoImportAlíquota de Imposto de ImportaçãoNumber($double)Não há
aliquotaIpiAlíquota IPINumber($double)Não há
NomeBairroNome do bairroStringNão há
TipoLogradouroTipo do logradouro. (Rua, avenida, etc.)StringNão há
DescricaoLogradouroNome do logradouroStringNão há
NumeroLogradouroNúmero do logradouroStringNão há
ComplementoLogradouroComplemento do logradouroindControlePfGera Arquivo Magnético DPFStringNão há
CEPCódigo postalStringNão há
TelefoneDDD1DDD do primeiro telefoneStringNão há
TelefoneNumero1Numero do primeiro telefoneStringNão há
TelefoneComplemento1Complemento do primeiro telefoneStringNão há
TelefoneDDD2DDD do segundo telefoneStringNão há
TelefoneNumero2Numero do segundo telefoneStringNão há
TelefoneComplemento2Complemento do segundo telefoneStringNão há
TelefoneDDD3DDD do terceiro telefoneStringNão há
TelefoneNumero3Numero do terceiro telefoneStringNão há
TelefoneComplemento3Complemento do terceiro telefoneStringNão há
NumeroCPFCNPJNúmero do CPF ou CNPJ sem dígitoStringNão há
DigitoCPFCNPJDígito do CPF ou CNPJcodTipiNcmCódigo TIPI do NCMInteger($int64)Não há
InscricaoEstadualRGNumero da inscrição estadualStringNão há
EmailE-mailStringNão há
HomePageSiteStringNão há
EstadoCivilEstado CivilindPermExcecaoPermite Informar uma ExceçãoStringNão há
statusStatus do NCM (A-ATIVO / I-INATIVO - Obs: Valores nulos/vazios são considerados como Ativos)StringNão há
dtaInicioVigenciaData inicial do período de vigênciaString ($date-time)Não há
dtaFimVigenciaData final do período de vigênciaString ($date-time)Não há
ContribuinteIcmsIdentificador de Contribuinte ICMS (Opções: S - Sim / N - Não)StringValores permitidos SN ou nulo.
ProdutorRuralIdentificador de Produtor Rural (Opções: S - Sim / N - Não)StringValores permitidos SN ou nulo.
MicroEmpresaIdentificador de Micro Empresa (Opções: S - Sim / N - Não)StringValores permitidos SN ou nulo.
InscricaoProdutorRuralInscrição de produtor ruralStringNão há
NumeroCNPJProdutorRuralNúmero do CNPJ de produtor rural sem dígitoStringNão há
DigitoCNPJProdutorRuralDígito do CNPJInteger($int64)Não há
ProdutorRuralComCPFIdentificador de Produtor Rural Com CPF (Opções: S - Sim / N - NãoindSubIcmsDifDiDeduz o valor do ICMS diferido com o ICMS próprio na geração do valor do item (Nota de Importação)StringValores permitidos SN ou nulo.
NumeroCPFProdutorRuralNúmero do CPF de produtor rural sem dígitoInteger($int64)Não há
DigitoCPFProdutorRuralDígito do CPFInteger($int64)Não há

Informações para Resposta (Response Information)

Códigos do Recurso (Response Codes)

  • Success (200201)
  • BadRequest (400)

Formatos de Resposta (Response Formats)

...

Bloco de código
languageactionscript3
{
  "codNcmexpandables": [
    "string"
  ],
  "versao": 99,
  "nomeRazaoSocial": "string",
  "fantasia": "string",
  "tipo": "s",
  "sexo": "s",
  "status": "s",
  "nomeCidade": "string",
  "ufCidade": "st",
  "paisCidade": "string",
  "codigoMunicipio": 99999,
  "codigoPais": 99999,
  "nomeBairro": "string",
  "tipoLogradouro": "string",
  "descricaoLogradouro": "string",
  "numeroLogradouro": "string",
  "complementoLogradouro": "string",
  "cep": "string",
  "telefoneDDD1": "strin",
  "descricaotelefoneNumero1": "string",
  "descReduzidatelefoneComplemento1": "string",
  "perImpostoImporttelefoneDDD2": 0"strin",
  "aliquotaIpitelefoneNumero2": 0"string",
  "indControlePftelefoneComplemento2": "string",
  "telefoneDDD3": "codTabGenerostrin",
  "telefoneNumero3": "string",
  "codTipiNcmtelefoneComplemento3": 0"string",
  "indPermExcecaonumeroCPFCNPJ": "string",
  "digitoCPFCNPJ": 99,
  "statusinscricaoEstadualRG": "string",
  "dtaInicioVigenciaemail": "string",
 "2021-07-12T16:41:56.506Z "homePage": "string",
  "estadoCivil": "s",
  "dtaFimVigenciacontribuinteICMS": "2021-07-12T16:41:56.506Z"s",
  "produtorRural": "s",
  "microEmpresa": "s",
  "usuarioAlteracaoinscricaoProdutorRural": "string",
  "indSubIcmsDifDinumeroCNPJProdutorRural": "string",
  "dtaAlteracaodigitoCNPJProdutorRural": "2021-07-12T16:41:56.506Z"99,
  "produtorRuralComCPF": "s",
  "numeroCPFProdutorRural": 9999999999999,
  "digitoCPFProdutorRural": 999
}

application/json, text/json

...