feat(sales): Sales Document Persistence Model and clean #55

New Issue

leandro · 2026-04-30T19:19:43Z

leandro commented

2026-04-30 19:19:43 +00:00

🎯 Objetivo

Definir e implementar la base de persistencia para el módulo de facturación en PhronCare, soportando:

Facturas (A/B/C)
Notas de débito / crédito
FCE / NDE / NCE (preparado, no implementado aún)
Separación entre documento comercial y fiscal (ARCA)

📌 Contexto funcional

Actualmente PhronCare posee:

Presupuestos (PhS_QuoteHeaders)
Remitos (PhS_DeliveryNotes)
Expediciones (PhLSMExpeditions)

Falta incorporar el concepto de documento de venta valorizado, independiente de:

logística (remitos)
intención comercial (presupuestos)

🧠 Decisiones de diseño

1. Separación de responsabilidades

Quote → intención comercial
DeliveryNote → ejecución logística
SalesDocument → valorización económica/fiscal

2. Modelo genérico (no “Invoices”)

Se define:

PhS_SalesDocuments

en lugar de:

Invoices / InvoiceDocuments ❌

para soportar múltiples tipos de comprobantes.

3. Numeración

✔ Interna → PhS_FormSeries
✔ Fiscal → ARCA (NO se persiste previamente)

Separación obligatoria:

internal_sequence_number ≠ voucher_number (AFIP)

4. Remitos

❌ NO obligatorios
✔ solo referencia opcional en cabecera
❌ NO FK en detalle

5. Origen de facturación

Detalle vinculado a:

quote_detail_id

Permite:

facturación parcial (60/40)
obra social / particular
ventas manuales

6. Fiscal desacoplado

PhS_SalesFiscalDocuments
PhS_SalesFiscalDocumentAssociations

Soporta:

CAE
idempotencia
request/response
reconciliación

🧱 Alcance

Tablas creadas

PhS_SalesDocuments
PhS_SalesDocumentDetails
PhS_SalesFiscalDocuments
PhS_SalesFiscalDocumentAssociations

Incluye

FK a PhS_FormSeries
FK a PhS_QuoteHeaders
FK a PhS_QuoteDetails
FK a PhS_Customers
FK a PhS_Products

Extended Properties

Se agregan MS_Description en:

tablas
columnas clave

🚫 Fuera de alcance

Lógica de negocio (Core)
Endpoints API
UI
Integración ARCA
Asientos contables

✅ Criterios de aceptación

Script SQL ejecuta sin errores
Tablas creadas correctamente
FKs válidas
Índices creados
Extended properties visibles
Scaffold EF funciona sin errores

🧪 Validación técnica

Ejecutar script en DB
Scaffold selectivo
Build OK
Validar DbContext

🌱 Decisiones futuras habilitadas

Facturación parcial
Multi-tenant fiscal
Idempotencia ARCA
Reconciliación por timeout
Soporte FCE

🔀 Branch sugerido

feature/leandro/55-sales-document-data-model

💬 Commit sugerido

feat(data): create sales document persistence model

closes #55

🚀 Próxima Story

👉 #57 — Core: creación y emisión de SalesDocument

servicio de creación
numeración interna
validaciones básicas
estados comerciales

## 🎯 Objetivo Definir e implementar la base de persistencia para el módulo de facturación en PhronCare, soportando: * Facturas (A/B/C) * Notas de débito / crédito * FCE / NDE / NCE (preparado, no implementado aún) * Separación entre documento comercial y fiscal (ARCA) --- ## 📌 Contexto funcional Actualmente PhronCare posee: * Presupuestos (`PhS_QuoteHeaders`) * Remitos (`PhS_DeliveryNotes`) * Expediciones (`PhLSMExpeditions`) Falta incorporar el concepto de **documento de venta valorizado**, independiente de: * logística (remitos) * intención comercial (presupuestos) --- ## 🧠 Decisiones de diseño ### 1. Separación de responsabilidades ```text Quote → intención comercial DeliveryNote → ejecución logística SalesDocument → valorización económica/fiscal ``` --- ### 2. Modelo genérico (no “Invoices”) Se define: ```text PhS_SalesDocuments ``` en lugar de: ```text Invoices / InvoiceDocuments ❌ ``` para soportar múltiples tipos de comprobantes. --- ### 3. Numeración * ✔ Interna → `PhS_FormSeries` * ✔ Fiscal → ARCA (NO se persiste previamente) Separación obligatoria: ```text internal_sequence_number ≠ voucher_number (AFIP) ``` --- ### 4. Remitos * ❌ NO obligatorios * ✔ solo referencia opcional en cabecera * ❌ NO FK en detalle --- ### 5. Origen de facturación Detalle vinculado a: ```text quote_detail_id ``` Permite: * facturación parcial (60/40) * obra social / particular * ventas manuales --- ### 6. Fiscal desacoplado ```text PhS_SalesFiscalDocuments PhS_SalesFiscalDocumentAssociations ``` Soporta: * CAE * idempotencia * request/response * reconciliación --- ## 🧱 Alcance ### Tablas creadas * `PhS_SalesDocuments` * `PhS_SalesDocumentDetails` * `PhS_SalesFiscalDocuments` * `PhS_SalesFiscalDocumentAssociations` --- ### Incluye * FK a `PhS_FormSeries` * FK a `PhS_QuoteHeaders` * FK a `PhS_QuoteDetails` * FK a `PhS_Customers` * FK a `PhS_Products` --- ### Extended Properties Se agregan `MS_Description` en: * tablas * columnas clave --- ## 🚫 Fuera de alcance * Lógica de negocio (Core) * Endpoints API * UI * Integración ARCA * Asientos contables --- ## ✅ Criterios de aceptación * Script SQL ejecuta sin errores * Tablas creadas correctamente * FKs válidas * Índices creados * Extended properties visibles * Scaffold EF funciona sin errores --- ## 🧪 Validación técnica 1. Ejecutar script en DB 2. Scaffold selectivo 3. Build OK 4. Validar DbContext --- ## 🌱 Decisiones futuras habilitadas * Facturación parcial * Multi-tenant fiscal * Idempotencia ARCA * Reconciliación por timeout * Soporte FCE --- ## 🔀 Branch sugerido ```bash feature/leandro/55-sales-document-data-model ``` --- ## 💬 Commit sugerido ```text feat(data): create sales document persistence model closes #55 ``` --- ## 🚀 Próxima Story 👉 **#57 — Core: creación y emisión de SalesDocument** * servicio de creación * numeración interna * validaciones básicas * estados comerciales

leandro referenced this issue from a commit

2026-04-30 19:21:20 +00:00

feat(eos): create sales document persistence model

leandro referenced a pull request that will close this issue

2026-04-30 19:23:14 +00:00

feat(eos): create sales document persistence model #56

leandro closed this issue

2026-04-30 19:23:31 +00:00

leandro changed title from ~~feat(eos): Sales Document Persistence Model and clean~~ to feat(sales): Sales Document Persistence Model and clean

2026-04-30 20:48:01 +00:00

leandro referenced this issue

2026-04-30 20:48:24 +00:00

feat(sales): Domain Contracts para Sales Document con Coverage #57

leandro referenced this issue from a commit

2026-05-02 19:24:16 +00:00

feat(api): add sales document coverage and period support

leandro referenced a pull request that will close this issue

2026-05-02 19:25:44 +00:00

feat(api): add sales document coverage and period support #58

leandro added the

STORY