Pular para o conteúdo principal

Rota para Inserir Regra dePara

Marcelo Luiz Baraldi
Atualizado

Nessa rota é possível solicitar a inserção de regras depara customizadas para cliente.

Requisição

Método HTTP

POST

 

Endpoint

https://sped.plugstorage.com.br/api/v2/sped/regrasDePara/

 

Query string

Nome Descrição
token Token de identificação da Software House.

 

Headers

Nome Valor
Authorization Basic encode64(email:senha)==

 

Body

Nome Tipo Obrigatório Descrição
icms Icms[] Não Array com lista de regras depara com tipo ICMS
pisCofins PisCofins[] Não Array com lista de regras depara com tipo PISCOFINS
ipi Ipi[] Não. Array com lista de regras depara com tipo IPI

 

Icms

Nome Tipo Obrigatório Descrição
cfopDe String Sim. Número CFOP de origem
cfopPara String Sim. Número CFOP de destino
cstDe String Sim. Número CST de origem
cstPara String Sim. Número CST de destino
destinacao String Sim.

destinacao dada ao produto

'A' - Ativo Imobilizado
'B' - Brindes
'C' - Uso e Consumo
'CP' - Consumo Industrialização
'FD' - Formulação DiretaI = Industrialização / Insumo / Embalagem
'O' - Outros
'R' - Revenda
'S' - Aplicado à Serviço
'T' - Revenda ST

creditoIcms String Sim.

Credita ICMS?

'0' - Não

'1' - Sim
creditoIcmsSt String Sim.

Credita ICMS Estadual?

'0' - Não

'1' - Sim
st String Sim.

Substituição tributária

'0' - Não

'1' - Sim

'2' - Sujeito
difal String Sim.

Diferencial de Alíquota do ICMS

'0' - Não

'1' - Sim

'2' - Sujeito

 

PisCofins

Nome Tipo Obrigatório Descrição
destinacao String Sim.

destinacao dada ao produto

'A' - Ativo Imobilizado
'B' - Brindes
'C' - Uso e Consumo
'FD' - Formulação DiretaI = Industrialização / Insumo / Embalagem
'O' - Outros
'R' - Revenda
'S' - Aplicado à Serviço
'T' - Revenda ST
cfop string Sim. Número CFOP de até 4 dígitos
cstDe String Sim. Número CST de origem
cstPara String Sim. Número CST de destino
pisAliquota String Sim Valor da alíquota em %
cofinsAliquota String Sim Valor da alíquota em %

 

Ipi

Nome Tipo Obrigatório Descrição
destinacao String Sim.

destinacao dada ao produto

'A' - Ativo Imobilizado
'B' - Brindes
'C' - Uso e Consumo
'FD' - Formulação DiretaI = Industrialização / Insumo / Embalagem
'O' - Outros
'R' - Revenda
'S' - Aplicado à Serviço
'T' - Revenda ST
cstDe String Sim. Número CST de origem
cstPara String Sim. Número CST de destino

Exemplo:

{
  "icms": [
  {
    "cfopDe": "5102",
    "cfopPara": "1102",
    "cstDe": "00",
    "cstPara": "20",
    "destinacao": "A",
    "creditoIcms": "1",
    "creditoIcmsSt": "0",
    "st": "1",
    "difal": "0"
  }
  ],
  "pisCofins": [
  {
    "cfop": "5102",
    "destinacao": "B",
    "cstDe": "01",
    "cstPara": "99",
    "pisAliquota": "1.65",
    "cofinsAliquota": "7.6"
  }
  ],
  "ipi": [
  {
    "destinacao": "C",
    "cstDe": "50",
    "cstPara": "99"
  }
  ]
}

 

Atenção!
⚠️ A validação da regra cadastrada é realizada de forma assíncrona. Por isso, após o cadastro, é necessário consultar o status para confirmar se a regra foi criada com sucesso.

⚠️ Para substituir uma regra DePara já apurada, após cadastrar a nova regra, é necessário realizar uma requisição para Reprocessar a apuração.

 

 

Resposta

Retorno de sucesso

Status code 201

{
  "message": "Inserção de regras DePara feita com sucesso. Realize a consulta pelo ID para verificar o status de sincronização.",
  "data": [{"sucesso": true, "regraDeparaId": "238472934dak98023fds390"}]
}

 

Retorno de erro

Status code 400

{
    "error": true,
    "parametro": \\campo\\
    "message": "Motivo de erro."
}

{
  "error": true,
  "message": "Já existe uma regra dePara cadastrada com exatamente os mesmos dados: [dados]."
}

 

Status code 401

Consulte essa documentação para saber os possíveis retornos de erros de autenticação.

Artigos relacionados

Comentários

0 comentário

Por favor, entre para comentar.