Função AdicionarEmpresa ( )
Para alterar os dados da empresa utilize o seguinte método HTTP: POST/AlterarDadosEmpresa/
O conteúdo do POST deverá conter somente os dados da empresa que você deseja alterar. O resultado será sucesso em alterar os dados da empresa ou uma mensagem de erro de validação.
Abaixo são listados todos os campos possíveis para alterar uma empresa.
|
Campo |
Tipo |
Obrigatório para uso de NF-e |
Obrigatório para uso de NFC-e |
Obrigatório para uso de NFS-e |
Descrição |
|
|---|---|---|---|---|---|---|
|
enderecodeacesso |
Texto | Sim | Sim | Sim | O endereço único de acesso que a empresa usará para ser identificada no cadastro. Obs.: Endereço será criado pelo desenvolvedor. Não pode ser alterado, apenas informe o endereço utilizado antes.*** |
|
|
razaosocial |
Texto |
Sim |
Sim |
Sim |
Razão social da empresa |
|
|
nomefantasia |
Texto |
Sim |
Sim |
Sim |
Nome fantasia |
|
|
responsavel |
Texto |
Sim |
Sim |
Sim |
Nome da pessoa responsável pela empresa |
|
|
ie |
Numérico |
Sim |
Sim |
NSA |
Inscrição estadual |
|
|
cnpj |
Texto |
Sim |
Sim |
Sim |
CNPJ |
|
|
crt |
Numérico |
Sim |
Sim |
Sim |
Regime tributário. Valores possíveis: |
|
|
emaile |
Texto |
Sim |
Sim |
Sim |
Email de contato da empresa |
|
|
telefone |
Numérico |
Sim |
Sim |
Não |
Telefone da empresa |
|
|
celular |
Numérico |
Não |
Não |
Não |
Celular da empresa |
|
|
endereco |
Texto |
Sim |
Sim |
Sim |
Endereço: logradouro |
|
|
numero |
Numérico |
Sim |
Sim |
Sim |
Endereço: número |
|
|
complemento |
Texto |
Não |
Não |
Não |
Endereço: complemento |
|
|
bairro |
Texto |
Sim |
Sim |
Sim |
Endereço: bairro |
|
|
cep |
Numérico |
Sim |
Sim |
Sim |
Endereço: CEP completo |
|
|
cidade |
Texto |
Sim |
Sim |
Sim |
Endereço: nome do município sem abreviações |
|
|
codigo_ibge |
Numérico |
Não |
Não |
Sim |
Informar o código cadastrado no IBGE referente a cidade da empresa. |
|
|
estado |
Texto |
Sim |
Sim |
Sim |
Endereço: UF com 2 caracteres |
|
|
modulonfe |
Numérico |
Sim |
NSA |
NSA |
Informe se empresa será habilitada para emissão de NFe – Nota Fiscal Eletrônica modelo 55. |
|
|
modulonfce |
Numérico |
NSA |
Sim |
NSA |
Informe se empresa será habilitada para emissão de NFCe – Nota Fiscal ao Consumidor Eletrônica modelo 65. |
|
|
modulonfse |
Numérico |
NSA |
NSA |
Sim |
Informe se empresa será habilitada para emissão de NFSe – Nota Fiscal de Serviço Eletrônica. |
|
|
nfe_serie |
Numérico |
Sim |
NSA |
NSA |
Informe a numeração da série em que a nota deverá ser emitida. |
|
|
nfe_numeracao |
Numérico |
Sim |
NSA |
NSA |
Informe a numeração inicial em que a nota deverá ser emitida. |
|
|
nfce_serie |
Numérico |
NSA |
Sim |
NSA |
Informe a numeração da série em que a nfc-e deverá ser emitida. |
|
|
nfce_numeracao |
Numérico |
NSA |
Sim |
NSA |
Informe a numeração inicial em que a nfc-e deverá ser emitida. |
|
|
nfce_itoken |
Texto |
NSA |
Sim |
NSA |
Itoken para emissão de NFCe em ambiente de produção. Sem este campo não será possível emitir NFCe em produção. Veja com o SEFAZ do seu estado como gerar este código. |
|
|
nfse_inscricaomunicipal |
Numérico |
NSA |
NSA |
Sim |
Inscrição municipal |
|
|
nfse_numerorps |
numérico |
NSA |
NSA |
Sim |
Informe a próxima numeração da RPS |
|
|
nfse_simplesnacional |
Numérico |
NSA |
NSA |
Sim |
Informe se empresa é optante pelo simples nacional – Nota Fiscal de Serviço Eletrônica |
|
|
nfse_incentivadorcultural |
Numérico |
NSA |
NSA |
Sim |
Informe se empresa é incentivadora cultural – Nota Fiscal de Serviço Eletrônica. |
|
|
nfse_CNAE |
Numérico |
NSA |
NSA |
Sim |
Código do CNAE principal da empresa |
|
|
nfse_regimeespecialtributacao |
Numérico |
NSA |
NSA |
Sim |
Regime tributário. Valores possíveis: |
|
|
nfse_aliquota |
Numérico |
NSA |
NSA |
Sim |
Alíquota utilizada pela empresa na emissão de NFSe pelo município. |
|
|
logotipo |
Texto |
Não |
Não |
Não |
* arquivo em formato JPG codificado em BASE64 |
|
|
nfse_numeroserie |
Texto |
NSA |
NSA |
Não |
Informe a numeração da série em que a nfse/RPS deverá ser emitida, dúvidas consulte o a Prefeitura |
|
| nfse_itemlistaservico | NSA | NSA | NSA | Sim | Código do serviço prestado. Conforme código do item da Lei Complementar 116/2003. Dúvidas consulte o a Prefeitura. | |
| webhook_url | Texto | NSA | NSA | NSA | Endereço da Url do webhook para você receber notificações diretamente no seu sistema sobre o andamento das notas fiscais. | |
|
SERVIÇO |
||||||
|
Servico-> codigo |
Numérico |
NSA |
NSA |
Sim |
Código do tipo de serviço prestado cadastrado na prefeitura pelo emissor. Ex: Código 01.05.03, coloque 010503. Mínimo 4 caracteres. |
|
|
Servico-> descricao |
Texto |
NSA |
NSA |
Sim |
Descrição dos serviços prestados pela empresa. |
|
Obs.: NSA - Não se aplica.
Exemplo de JSon
{
"ApiKey":"xxxxapikeyhashxxx",
"Cnpj":"00.000.000/000-00",
"Dados":{
"enderecodeacesso ":"Enderecodeacesso",
"razaosocial ":"Nome da empresa Ltda",
"nomefantasia ":"Nome Fantasia",
"responsavel":"Nome Responsavel",
"ie":0653803583,
"cnpj":"12345678901114",
"crt ":1,
"emaile ":"email@empresateste.com.br",
"telefone":5133333333,
"endereco":"Rua Adalberto Silva",
"numero":200,
"complemento":"Loja 1",
"bairro":"Sarandi",
"cep":91120415,
"cidade":"Porto Alegre",
"codigo_ibge":4314902,
"estado":"RS",
"modulonfe ":1,
"modulonfce ":1,
"modulonfse":1,
"nfe_serie":2,
"nfe_numeracao":12,
"nfce_serie":3,
"nfce_numeracao":45,
"nfce_itoken":"C2ED8B5A-CV4B-96BA-8D96-13547D8ABFEE",
"nfse_inscricaomunicipal":27462874,
"nfse_numerorps":59,
"nfse_simplesnacional":1,
"nfse_incentivadorcultural":2,
"nfse_CNAE":8521301,
"nfse_regimeespecialtributacao":6,
"nfse_aliquota":0,
"nfse_itemlistaservico":107,
"Servicos":[
[
{
"codigo":010700100,
"descricao":"Suporte técnico em informática"
}
],
[
{
"codigo":010600100,
"descricao":"Assessoria e consultoria em informática"
}
]
]
}
}
Retornos e Erros
Todos os códigos de erros com os dois primeiros dígitos sendo 20 são associados a função: AlterarDadosEmpresa| Código | Campo | Mensagem de retorno |
|---|---|---|
| 201 | cnpj | O CNPJ informado para acesso não corresponde ao CNPJ informado para cadastro |
| 202 | modulonfe | A opção de módulo NF-e deve ser informada |
| 203 | modulonfce | A opção de módulo NFC-e deve ser informada |
| 204 | modulonfse |
- A opção de módulo NFS-e deve ser informada - É preciso configurar como SIM ao menos uma opção NF-e ou NFC-e ou NFS-e |
| 205 | razaosocial | É preciso informar a Razão Social da empresa |
| 206 | nomefantasia | É preciso informar o Nome Fantasia da empresa |
| 207 | logotipo |
- É preciso enviar um logotipo em formato JPG válido codificado em BASE64 - É preciso enviar um logotipo em formato JPG válido - É preciso enviar um logotipo em formato JPG válido nas dimensões: 200x100 px |
| 208 | ie | É preciso informar a Inscrição Estadual da empresa |
| 209 | nfse_inscricaomunicipal | É preciso informar a Inscrição Municipal da empresa |
| 2010 | nfse_simplesnacional | É preciso informar se a empresa é optante pelo simples nacional |
| 2011 | nfse_incentivadorcultural | É preciso informar se a empresa é incentivadora cultural |
| 2012 | nfse_CNAE | É preciso informar o código do CNAE principal da empresa |
| 2013 | nfse_regimeespecialtributacao | É preciso informar um código do Regime Especial de Tributação válido |
| 2014 | nfse_itemlistaservico | É preciso informar Código do serviço prestado da empresa. Conforme código do item da Lei Complementar 116/2003 |
| 2015 | nfse_codigotributacaomunicipio | É preciso informar o Código do serviço prestado da empresa. Conforme código informado pelo município |
| 2016 | nfse_aliquota | É preciso informar a aliquota utilizada pela empresa no municipio |
| 2017 | descricaoservicos | É preciso informar a descrição dos serviços prestados pela empresa |
| 2018 | crt | É preciso informar um CRT válido para a empresa |
| 2019 | emaile | É preciso informar o E-mail da empresa |
| 2020 | telefone | É preciso informar o Telefone da empresa |
| 2021 | responsavel | É preciso informar o Responsável da empresa |
| 2022 | endereco | É preciso informar o Endereço da empresa |
| 2023 | numero | É preciso informar o Número da empresa |
| 2024 | bairro | É preciso informar o Bairro da empresa |
| 2025 | cep |
- É preciso informar o Cep da empresa - É preciso informar um CEP válido para a empresa |
| 2026 | cidade | É preciso informar a Cidade da empresa |
| 2027 | estado | É preciso informar o Estado da empresa |
| 2028 | nfce_itoken | É preciso informar o ITOKEN da NFC-e da empresa |
| 2029 | nfe_serie | É preciso informar a numeração da série em que a nfe deverá ser emitida |
| 2030 | nfe_numeracao | É preciso informar a numeração inicial em que a nfe deverá ser emitida |
| 2031 | nfce_serie | É preciso informar a numeração da série em que a nfce deverá ser emitida |
| 2032 | nfce_numeracao | É preciso informar a numeração inicial em que a nfce deverá ser emitida |
| 2033 | nfse_numerorps | É preciso informar a próxima numeração da RPS |
| 2034 | Retorno com erro | |
| 2035 | Retorno com sucesso | |
Retornos de JSON
| Retorno com erro de parametros |
|---|
| { "Status": "Erro", "codigo": "codigo_erro", "campo": "campo_com_erro", "descricao": "descricao_erro" } |
| Retorno com erro |
|---|
| { "status": "Erro", "codigo": "2034", "descricao": "Houve um erro ao tentar alterar os dados da empresa" } |
| Retorno com sucesso |
|---|
| { "status": "OK", "codigo": "2035", "descricao": "A empresa foi alterada com sucesso" } |