Pular para o conteúdo principal

StockInvoice (Nota Fiscal de Entrada)

O StockInvoice representa uma nota fiscal de entrada de mercadorias.

Descricao​

A nota fiscal de entrada registra a documentacao fiscal das compras de produtos, permitindo rastreabilidade, conciliacao e controle fiscal.

Dados​

Identificacao​

CampoTipoObrigatorioDescricao
numberTextoSimNumero da NF
seriesTextoSimSerie da NF
keyTextoNaoChave de acesso (44 digitos)
issue_dateDataSimData de emissao
entry_dateDataSimData de entrada

Emitente​

CampoTipoDescricao
provider_idReferenciaFornecedor
provider_nameTextoRazao social
provider_cnpjTextoCNPJ
provider_ieTextoInscricao estadual

Valores​

CampoTipoDescricao
products_totalMonetarioTotal dos produtos
discountMonetarioDesconto
shippingMonetarioFrete
insuranceMonetarioSeguro
other_costsMonetarioOutras despesas
ipi_totalMonetarioTotal IPI
icms_st_totalMonetarioTotal ICMS ST
totalMonetarioTotal da NF

Status​

StatusDescricao
pendingPendente de processamento
processingEm processamento
processedProcessada
partially_processedParcialmente processada
canceledCancelada
rejectedRejeitada

Relacionamentos​

Pertence a​

EntidadeObrigatorioDescricao
AccountSimConta do petshop
StoreSimFilial
ProviderSimFornecedor
StockPurchaseNaoOrdem de compra
UserSimUsuario que importou

Possui​

EntidadeDescricao
InvoiceItemsItens da nota
StockTransactionsMovimentacoes geradas

InvoiceItem​

Dados do Item​

CampoTipoDescricao
sequenceNumeroSequencia na NF
product_codeTextoCodigo do produto
product_descriptionTextoDescricao na NF
ncmTextoNCM
cfopTextoCFOP
unitTextoUnidade
quantityDecimalQuantidade
unit_valueMonetarioValor unitario
total_valueMonetarioValor total

Impostos do Item​

CampoTipoDescricao
icms_baseMonetarioBase ICMS
icms_rateDecimalAliquota ICMS
icms_valueMonetarioValor ICMS
icms_st_baseMonetarioBase ICMS ST
icms_st_rateDecimalAliquota ICMS ST
icms_st_valueMonetarioValor ICMS ST
ipi_baseMonetarioBase IPI
ipi_rateDecimalAliquota IPI
ipi_valueMonetarioValor IPI
pis_valueMonetarioValor PIS
cofins_valueMonetarioValor COFINS

Vinculo com Produto​

CampoTipoDescricao
sale_product_idReferenciaProduto do sistema
linkedBooleanoSe foi vinculado
link_methodSelecaoComo foi vinculado

Fluxo de Importacao​

Vinculo de Itens​

Metodos de Vinculo​

MetodoDescricaoPrioridade
Codigo fornecedorProductProvider.code1
Codigo de barrasBarcodes da NF2
NCM + DescricaoMatch por NCM e descricao3
ManualUsuario seleciona4

ProductProvider​

Ao vincular, cria registro para futuras importacoes:

ProductProvider
provider_id: fornecedor
sale_product_id: produto
code: codigo_na_nf
barcode: ean_na_nf

Calculo de Custos​

Custo do Produto​

O custo considera:

custo_produto = (valor_produto + frete_rateado + seguro_rateado + outras_despesas_rateadas + ipi) / quantidade

Rateio de Custos​

Frete, seguro e outras despesas sao rateados proporcionalmente:

frete_item = frete_total * (valor_item / valor_total_produtos)

ICMS ST no Custo​

ICMS ST pode ou nao compor o custo:

OpcaoComportamento
IncluirICMS ST entra no custo
ExcluirICMS ST nao entra no custo

Processamento​

Ao Processar​

  1. Valida todos os itens vinculados
  2. Gera StockTransaction para cada item
  3. Atualiza estoque
  4. Atualiza custo do produto
  5. Gera FinancialTransaction (se configurado)

Transacoes Geradas​

Para cada item:
StockTransaction
type: entry
entry_type: purchase
quantity: quantidade_nf
unit_cost: custo_calculado
invoice_id: esta_nf

Cancelamento​

Tipos de Cancelamento​

TipoAcao
Nao processadaApenas cancela registro
ProcessadaReverte estoque e financeiro

Reversao​

Se ja processada:

  • Gera transacoes de estoque inversas
  • Cancela transacao financeira

Validacoes​

CampoRegra
numberObrigatorio
seriesObrigatorio
keyUnico (se informado)
issue_dateObrigatorio
providerObrigatorio
itemsMinimo 1 item

Validacoes Fiscais​

ValidacaoDescricao
Chave de acessoDigito verificador valido
CNPJ emitenteCNPJ valido
DuplicidadeMesma NF nao pode ser importada 2x

Manifestacao​

Manifestacao do Destinatario​

Para NF-e destinada ao CNPJ:

EventoDescricao
CienciaCiencia da operacao
ConfirmacaoConfirma operacao
DesconhecimentoDesconhece operacao
Nao realizadaOperacao nao realizada

Relatorios​

RelatorioDescricao
Notas por periodoNFs importadas no periodo
Notas por fornecedorAgrupado por fornecedor
Itens pendentesItens sem vinculo
CustosEvolucao de custos

Integracao​

Com Ordem de Compra​

Se vinculada a ordem de compra:

  • Valida itens vs ordem
  • Atualiza status da ordem
  • Registra recebimento

Com SEFAZ​

Pode consultar situacao da NF-e:

  • Autorizada
  • Cancelada
  • Inutilizada

Permissoes​

AcaoDescricao
ImportarImportar XML
VincularVincular itens
ProcessarProcessar NF
CancelarCancelar NF
ManifestarManifestar destinatario