Provider (Fornecedor)

O Provider representa um fornecedor de produtos do petshop.

Descricao

Fornecedores sao as empresas que vendem produtos para o petshop. O cadastro permite rastrear compras, gerenciar relacoes comerciais e fazer conciliacao de notas fiscais.

Dados

Identificacao

Campo	Tipo	Obrigatorio	Descricao
name	Texto	Sim	Nome/Razao Social
trade_name	Texto	Nao	Nome Fantasia
cnpj	Texto	Nao	CNPJ
cpf	Texto	Nao	CPF (se pessoa fisica)
ie	Texto	Nao	Inscricao Estadual

Contato

Campo	Tipo	Descricao
email	Texto	Email de contato
phone	Texto	Telefone
contact_name	Texto	Nome do contato

Endereco

Campo	Tipo	Descricao
address	Texto	Endereco
number	Texto	Numero
complement	Texto	Complemento
neighborhood	Texto	Bairro
city	Texto	Cidade
state	Texto	Estado
zip_code	Texto	CEP

Configuracoes

Campo	Tipo	Descricao
active	Booleano	Se esta ativo
notes	Texto	Observacoes

Relacionamentos

Pertence a

Entidade	Obrigatorio	Descricao
Account	Sim	Conta do petshop

Possui

Entidade	Descricao
SaleProducts	Produtos deste fornecedor
StockMovements	Entradas de mercadoria
StockInvoices	Notas fiscais
FinancialTransactions	Transacoes de pagamento
ProductProviders	Codigos de produtos

ProductProvider

Descricao

Vinculo entre produto e fornecedor, armazenando o codigo do produto no fornecedor.

Dados

Campo	Tipo	Descricao
sale_product_id	Referencia	Produto
provider_id	Referencia	Fornecedor
code	Texto	Codigo do produto no fornecedor
barcode	Texto	Codigo de barras do fornecedor

Uso

• Facilita importacao de notas fiscais
• Permite conciliacao automatica
• Evita duplicidade de produtos

Importacao de Nota Fiscal

Processo

1. Importar XML da NF-e
2. Sistema identifica fornecedor pelo CNPJ
3. Para cada produto na nota:
   • Busca por codigo do fornecedor
   • Ou busca por codigo de barras
   • Se nao encontrado: solicita vinculo

Conciliacao

Financeiro

Contas a Pagar

Transacoes financeiras do tipo "expense" podem ser vinculadas ao fornecedor:

FinancialTransaction
  type: expense
  provider_id: [este fornecedor]

Relatorios

• Total de compras por fornecedor
• Historico de pagamentos
• Produtos comprados

Validacoes

Campo	Regra
name	Obrigatorio
cnpj	Unico por conta (se informado)

Escopos

Escopo	Descricao
active	Apenas ativos

Permissoes

Acao	Descricao
Criar	Cadastrar fornecedor
Editar	Alterar dados
Desativar	Marcar como inativo
Ver compras	Historico de compras
Ver financeiro	Contas a pagar