Pular para o conteúdo principal

Criar Filial

Conceituação#

Neste método você pode cadastrar uma filial


Método#

Para registrar a filial, usaremos o método: /api/v3/branches

POST https://api.kigisistemas.com.br/mobiage-api/api/v3/branches

Neste método usaremos as Headers:

KEYVALUE
Content-Typeapplication/json
gumgaTokenSeu Token

Atributos#

Opcionais#


Request Params#

POST https://api.kigisistemas.com.br/mobiage-api/api/v3/branches

Response#

200#

AtributosTipoDescrição
thirdIdstringid da empresa
registerNamestringNome de registro da empresa
socialNamestringNome social da empresa
shortNamestringNome abreviado da empresa
federalDocumentstringCNPJ da empresa sem pontuação
stateDocumentstringInscrição estadual da empresa sem pontuação
stateIndicatorstringIndicador da Inscrição estadual
telephonesstring[]Lista de telefones
emailsstring[]Lista de e-mails
adressesAddress[]Lista de endereços
activebooleanIndica se o cadastro está ativo
urlPhotostringURL de uma foto da empresa
registrationDateDateData de criação do cadastro
dateOfFoundationDateData de fundação da empresa
modalityModalityModalidade da empresa
isFranchiseeBooleanIdentifica se é um franqueado
isFranchisorBooleanIdentifica se é um franqueador
isMatrixBooleanIdentifica se é uma matriz
userIdStringID do usuário responsável pela criação da empresa

Address {array}#

AtributoTipoDescrição
zipCodestringCEP sem pontuação
premissestringLocalização. Exemplo: Avenida Paulista
numberstringNúmero da localização
informationstringComplemento do endereço
neighbourhoodstringBairro do endereço
localizationstringCidade
statestringEstado. Exemplo: SP, PR, SC, ES, etc.
countrystringPaís. Exemplo: Brasil
formalCodestringcódigo IBGE da cidade
stateCodestringcódigo do estado
isPrimarystringidentifica se o endereço é o principal ou não

stateIndicator#

TipoDescrição
stringopções: CONTRIBUINTE ou ISENTO ou NAO_CONTRIBUINTE

Modality#

TipoDescrição
stringopções: RETAIL-[Varejo] ou WHOLESALE=[Atacado]

Exemplo

{
"thirdId": 11111111,
"registrationDate": "2023-01-01T16:29:39.316Z",
"active": true,
"adresses": [
{
"zipCode": "00000000",
"premisse": "Avenida Paulista",
"number": "1060",
"neighbourhood": "Zona 07",
"localization": "São Paulo",
"state": "PR",
"country": "Brasil",
"formalCode": "222222",
"stateCode": "33",
"isPrimary": true
}
],
"emails": ["email@exemplo.com"],
"telephones": ["4400000000"],
"registerName": "RAZAO SOCIAL DA EMPRESA",
"socialName": "NOME FANTASIA DA EMPRESA",
"modality": "RETAIL",
"federalDocument": "00000000000000",
"shortName": "Filial São Paulo",
"dateOfFoundation": "2023-01-01T15:00:00.000Z",
"stateDocument": "",
"stateIndicator": "NAO_CONTRIBUINTE",
"isFranchisee": false,
"isMatrix": false,
"isFranchisor": false,
"userId": "00000"
}
____________________________________________________________________________________