Árvore de páginas

Versões comparadas

Chave

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

Este método é responsável pelo envio pela criação de statusloja

  • Endpoint: /api/retaguarda/v2/lojas
  • Método: Post
  • Autenticação: Bearer token
  • Permissão: Retaguarda

Este endpoint recebe uma lista de lojas para que possam ser enviados vários na mesma requisição

Aviso

Para que a baixa da loja criada ocorra no PDV Omni é necessário realizar a abertura de um lote do tipo 1 = loja

Expandir
titleExemplo de body da requisição

[
    {
        "bairro": "string",
        "cep": "string",
        "loteOrigemcidade": "string",
        "idInquilinocnpj": "string",
        "idRetaguardacodigoIdentificacaoLoja": "string",
        "idProprietariocodigoMaster": "string",
        "razaoSocialcodigoMunicipioIbge": "string",
        "nomeFantasiacodigoOrganizacional": "string",
        "cnpjcodigoUFIBGE": "string",
        "inscricaoEstadualcomplemento": "string",
        "endereco": "string",
        "numeroestado": "string",
        "bairroidDominioManutencao": "string",
        "cidadeidInquilino": "string",
        "estadoidProprietario": "string",
        "siglaUfidRetaguarda": "string",
        "CodigoUFIBGEidRetaguardaRede": "string",
        "CodigoMunicipioIbgeinscricaoEstadual": "string",
        "cepinscricaoMunicipal": "string",
        "complementoloteOrigem": "string",
        "modeloFiscal": 0,
        "nomeFantasia": "string",
        "regimeTributarionomeMaster": 0"string",
        "redenumero": "string",
        "numeroLoja": "string",
        "telefonerazaoSocial": "string",
        "inscricaoMunicipalrede": "string",
        "codigoIdentificacaoLoja"regimeTributario": 0,
        "siglaUf": "string",
        "situacao": 1,
        "telefone": "string"
    }
]

Expandir
titleDefinição dos campos de requisição

Campo

Tipo

Descrição

Observações

Obrigatório

Regras do campo

Observações


loteOrigem

stringCódigo do loteSim

idInquilino

stringIdentificador do inquilinoSim

idRetaguarda

stringIdentificador da loja na retaguarda

Sim

Tamanho máximo: 100 caracteres


idProprietario

stringIdentificador do proprietário. (Adicionando na criação do compartilhamento)Sim

razaoSocial

stringRazão social da loja

Sim

Tamanho máximo (50)


nomeFantasia

stringNome Fantasia da loja

Sim

Tamanho máximo (50)


cnpj

stringCNPJ da lojaSimTamanho máximo (14)

inscricaoEstadual

stringInscrição estadual da lojaSim

Tamanho máximo (15)

Tamanho mínimo (2)


endereco

stringEndereço da loja

Sim

Tamanho máximo (200)

Tamanho mínimo (2)


numero

stringNúmero do local da lojaNãoTamanho máximo (10)

bairro

stringBairro da loja

Sim

Tamanho máximo (150)

Tamanho mínimo (2)


cidade

sringCidade da loja

Sim

Tamanho máximo (150) 

Tamanho mínimo (2)


estado

stringEstado da loja

Sim

Tamanho máximo (50)


siglaUf

stringSigla do estado da lojaSim

Tamanho máximo (2)

Tamanho mínimo (2)


CodigoUFIBGE

stringCódigo do estadoSimTamanho igual (2)

CodigoMunicipioIbge

stringCódigo do municípioNãoTamanho igual (7)

cep

stringCep da lonaSim Tamanho máximo (8)

complemento

stringComplemente do endereço da loja

Não

Tamanho máximo (100) 

Tamanho mínimo (2)


modeloFiscal

int
EnumModelo fiscal utilizado (Tipos abaixo)Não

Enviar um dos tipos abaixo.

Caso não tenha definido o valor deste campo, informar "null" ou não enviar esse campo na requisição 

regimeTributario

intRegime tributário utilizado (Tipos abaixo)Sim

rede

stringRede da loja

Sim

Tamanho máximo (40)


numeroLoja

stringNumero da lojaSimTamanho máximo (30)

telefone

stringTelefone da loja

Não



Informar somente os números

inscricaoMunicipal

stringInscrição municipal da lojaNãoTamanho máximo (15)

codigoIdentificacaoLoja

stringCódigo de identificação da loja

Sim

Tamanho máximo (20)


situacao

intSituação da loja (Tipos abaixo)Sim

idRetaguardaRede

stringIdentificador da rede naretaguardaNãoTamanho máximo (100)

codigoMaster

stringCódigo masterNãoTamanho máximo (50)

nomeMaster

stringNome masterNãoTamanho máximo (50)

idDominioManutencao

stringIdentificador dominio manutençãoNão

codigoOrganizacional

stringCodigo OrganizacionalNão

HTTP 400 - Bad Request
Expandir
titleTipos de Regime Tributário
CódigoNome
0SimplesNacional
1RegimeNormal
Expandir
title
Expandir
titleRetornosTipos de Modelo fiscal
CódigoNome
0NaoConfigurado
1SAT
2NFCe
3MFE
Expandir
titleRetornos

{
    "success": true,
    "message": "",
    "data": null,
    "errors": null,
    "totalTime": 0,
    "numberOfRecords": 0
}

Retorno ocorre quando uma campo obrigatório não é enviado

{
    "code": "",
    "message": "",
    "detailedMessage": "",
    "helpUrl": "",
    "details": [
        {
            "guid": "23d3d6cd-084d-413a-8b1f-f596df5a9fe6",
            "code": "CQIFlap.Pber.Pbagebyr.Qbznva.Ragvgvrf.FgnghfFreivpb.FgnghfFreivpb+Reebe.5",
            "message": "O Status deve conter um status.",
            "detailedMessage": "StatusShouldHaveStatusSpecification"
        }
    ]
}
Expandir
titleDefinição dos campos de retorno

Campo

Tipo

Descrição

SuccessboolIndica se a criação da loja foi feita com sucesso
MessagestringCaso ocorra erros durante a criação da loja eles serão enviados nesse campo
DataobjetoObjeto loja criado
ErrorsListaListas com os erros encontrados no processo
TotalTimeinttempo da requisição
NumberOfRecordsintnúmero de dados inseridos
Expandir
titleHTTP 200 - OK

{
    "success": true,
    "message": "",
    "data": {
        "aplicacao": "AplicacaoTeste",
        "retaguarda": "RetaguardaTeste",
        "servico": "ServicoTeste",
        "idLojaRetaguarda": "IdLojaRetaguardaTeste",
        "dispositivo": "DispositivoTeste",
        "idDevice": "IdDeviceTeste",
        "status": "StatusTeste",
        "dataServidor": "2023-11-22T13:00:00Z",
        "idInquilino": "IdInquilinoTeste",
        "dataAtualizacao": "2023-11-22T15:24:38.1057876Z",
        "dataCadastro": "2023-11-22T15:24:38.105787Z",
        "id": "19",
        "_expandables": []
    }
}

Expandir
titleHTTP 400 - Bad Request