Rota para Inserir Nota Manual – Central de Atendimento

Nessa rota é possível solicitar a inserção de Notas manualmente no sistema.

Requisição

Método HTTP

POST

Endpoint

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

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
modelo	String	Sim.	'1' - NF Entrada/Saída '2' - NF Venda Consumidor '6' - NF/Conta Energia '7' - NF Serv. Transporte '8' - CTRC '21' - NF Serv. Comunicação '22' - NF Serv. Telecomunicação '28' - NF/Conta Gás '29' - NF/Conta Água
serie	String	Sim.	Série da NFe
numero	String	Sim.	Número da NFe
emissao	String (YYYY-MM-DD)	Sim.	Data de emissão -
entradaData	String (YYYY-MM-DD)	Sim.	Data de envio da nota
freteModalidade	String	Sim.	'0' - Por conta do emitente '1' - Por conta do destinatário/remetente '2' - Por conta de terceiros '9' - Sem cobrança de frete
formaPagamento	String	Sim.	'0' - À Vista '1' - À Prazo '2' - Outros
participanteCpfCnpj	String	Sim.	CPF ou CNPJ de Participante registrado na rota POST /Participante
itens	Array<Item>	Sim.	Array com itens da nota

Item

Nome	Tipo	Obrigatório	Descrição
codigo	String	Sim.	Código único do item (valor definido pelo emissor)
descricao	String	Sim.	Descrição do item
ncm	String	Sim.	código NCM com 8 dígitos.
cest	String	Sim	Código CEST
cfop	String	Sim	Código CFOP
unidade	String	Sim	Texto descrevendo o tipo de unidade (ex: kg, duzia, palets, UN)
qtde	String	Sim	Quantas unidades do item
valorUnitario	Float	Não	Valor Unitário
valorProduto	Float	Sim	Valor do item
desconto	Float	Não	Valor desconto do item
frete	Float	Não.	Valor do frete do item
seguro	Float	Não.	Valor do seguro do item
outro	Float	Não.	Valor de Outros Valores
ean	String	Não.	Código ean do item
extipi	String	Não.	código extipi do item
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
tributos	Tributos	Sim.	Objeto contendo valores dos tributos

Tributos

Nome	Tipo	Obrigatório	Descrição
icms	Icms	Não.	Objeto contendo valores de ICMS
pisCofins	PisCofins	Não.	Objeto contendo valores de PIS COFINS
ipi	Ipi	Não.	Objeto contendo valores de IPI

Icms

Nome	Tipo	Obrigatório	Descrição
orig	String	Sim.	'0' - Nacional, exceto as indicadas nos códigos 3 a 5 '1' - Estrangeira - importação direta, exceto a indicada no código 6 '2' - Estrangeira – adquirida no mercado interno, exceto a indicada no código 7 '3' - Nacional, mercadoria ou bem com conteúdo de importação superior a 40% '4' - Nacional, produção feita em conformidade com os processos produtivos básicos da leis... '5' - Nacional, mercadoria ou bem com conteúdo de importação inferior ou igual a 40% '6' - Estrangeira - importação direta, sem similar nacional, constante em lista do CAMEX '7' - Estrangeira - adquirida no mercado interno, sem similar nacional, constante em lista do CAMEX '8' - Nacional, mercadoria ou bem com Conteúdo de Importação superior a 70%
cst	String	Sim.	'00' - Tributada integralmente '02' - Tributação monofásica própria sobre combustíveis '10' - Tributada e com cobrança do ICMS por ST '15' - Tributação monofásica própria e com responsabilidade pela retenção sobre combustíveis '20' - Com redução de base de cálculo '30' - Isenta/Não tributada e com cobrança do ICMS por ST '40' - Isenta '41' - Não Tributada '50' - Suspensão '51' - Diferimento '53' - Tributação monofásica sobre combustíveis com recolhimento diferido '60' - Cobrado por ST '61' - Tributação monofásica sobre combustíveis cobrada anteriormente '70' - Com redução de base de cálculo cobrança do ICMS por ST '90' - Outras '101' - Tributada pelo Simples Nacional com permissão de crédito '102' - Tributada pelo Simples Nacional sem permissão de crédito '103' - Isenção do ICMS no Simples Nacional para faixa de receita bruta '201' - Tributada pelo Simples Nacional com permissão de crédito e com cobrança do ICMS por substituição tributária '202' - Tributada pelo Simples Nacional sem permissão de crédito e com cobrança do ICMS por substituição tributária '203' - Isenção do ICMS no Simples Nacional para faixa de receita bruta e com cobrança doICMS por substituição tributária '300' - Imune '400' - Não tributada pelo Simples Nacional '500' - ICMS cobrado anteriormente por substituição tributária (substituído) ou por antecipação '900' - Outros
baseCalculo	Float	Sim.	Valor da base de cálculo
aliquota	Float	Sim	Valor da alíquota em %
valor	Float	Sim	Valor do ICMS
baseCalculoST	Float	Sim	Valor da base de Calculo ST
aliquotaST	Float	Sim	Valor da alíquota em %
valorST	Float	Sim	Valor da ST

PisCofins

Nome	Tipo	Obrigatório	Descrição
cst	String	Sim.	'01' - Op. Trib c/ Alíq Básica '02' - Op. Trib. c/ Alíq Diferenciada '03' - Op. Trib. c/ Alíq por Un de Medida de Produto '04' - Op. Trib. Monofásica '05' - Oper. Trib. por Sub. Tributária '06' - Op. Trib a Alíq Zero '07' - Operação Isenta da Contribuição '08' - Operação sem Incidência da Contribuição '09' - Operação com Suspensão da Contribuição '49' - Outras Operações de Saída
pisAliquota	Float	Sim.	Valor da alíquota em %
pisValor	Float	Sim.	Valor PIS
cofinsAliquota	Float	Sim	Valor da alíquota em %
cofinsValor	Float	Sim	Valor Cofins

ipi

Nome	Tipo	Obrigatório	Descrição
aliquota	Float	Sim.	Valor da alíquota em %
valor	Float	Sim.	valor Ipi

Exemplo:

{
  "serie": "01",
  "modelo": "1",
  "emissao": "2025-02-12",
  "entradaData": "2025-02-12",
  "numero": "5",
  "freteModalidade": "0",
  "formaPagamento": "0",
  "participanteCpfCnpj": "08187168000160",
  "itens": [
  {
    "codigo": "1",
    "descricao": "Item 01",
    "ncm": "12345678",
    "cest": "123",
    "cfop": "1234",
    "unidade": "UN",
    "qtde": "1",
    "valorUnitario": "1.10",
    "valorProduto": "1.10",
    "destinacao": "A",
        "tributos": {
            "icms": {
            "orig": "1",
            "cst": "00",
            "baseCalculo": "1.10",
            "aliquota": "0",
            "valor": "0.10",
            "baseCalculoST": "0",
            "aliquotaST": "0",
            "valorST": "0"
            }
        }
    },
    {
    "codigo": "2",
    "descricao": "Item 02",
    "ncm": "12345678",
    "cest": "123",
    "cfop": "1234",
    "unidade": "UN",
    "qtde": "1",
    "valorUnitario": "1.10",
    "valorProduto": "1.10",
    "destinacao": "A",
    "tributos": {
        "icms": {
        "orig": "1",
        "cst": "00",
        "baseCalculo": "1.10",
        "aliquota": "0",
        "valor": "0.10",
        "baseCalculoST": "0",
        "aliquotaST": "0",
        "valorST": "0"
        }
      }
    }
  ]
}

Resposta

Retorno de sucesso

Status code 201

{
    "message": "Inserção de Nota iniciada manualmente com sucesso.",
    "id": "6787cc7a3b9372c410a13e95"
}

Retorno de erro

Status code 400

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

Status code 401

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