132 lines
3.1 KiB
Markdown
132 lines
3.1 KiB
Markdown
# Formatos de Entrada
|
||
|
||
La API detecta automáticamente el formato de entrada. No hay que indicarlo.
|
||
|
||
## Endpoint
|
||
|
||
```
|
||
POST /api/v1/facturas → Formato detectado automáticamente
|
||
GET /api/v1/formats → Lista formatos soportados
|
||
```
|
||
|
||
---
|
||
|
||
## Formato: `native`
|
||
|
||
Formato propio de la API. Se detecta por la presencia del campo `factura`.
|
||
|
||
```json
|
||
{
|
||
"tipo": "alta",
|
||
"factura": {
|
||
"emisor_nif": "A12345678",
|
||
"emisor_nombre": "EMPRESA EJEMPLO SL",
|
||
"num_serie": "2024-001",
|
||
"fecha_expedicion": "13-09-2024",
|
||
"tipo_factura": "F1",
|
||
"descripcion": "Servicios de consultoría",
|
||
"destinatario": {
|
||
"nombre": "CLIENTE SL",
|
||
"nif": "B98765432"
|
||
},
|
||
"iva": [
|
||
{"base": 100.00, "cuota": 21.00, "tipo": 21.00}
|
||
],
|
||
"importe_total": 121.00
|
||
},
|
||
"sistema": {
|
||
"nombre": "Mi Software",
|
||
"nif_proveedor": "A12345678",
|
||
"version": "1.0.0"
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## Formato: `dolibarr`
|
||
|
||
Compatible con el formato que la web envía al BFF de Dolibarr. Los campos numéricos son `number` (no strings) y las fechas son ISO 8601. Se detecta por la presencia del campo `invoice`.
|
||
|
||
```json
|
||
{
|
||
"invoice": {
|
||
"number": "FA2024/001",
|
||
"date": "2024-09-13T00:00:00Z",
|
||
"notePublic": "Servicios de consultoría",
|
||
"lines": [
|
||
{"description": "Servicio A", "quantity": 1, "unitPrice": 60, "taxRate": 21},
|
||
{"description": "Servicio B", "quantity": 2, "unitPrice": 40, "taxRate": 10}
|
||
]
|
||
},
|
||
"client": {
|
||
"name": "CLIENTE SL",
|
||
"vatNumber": "B98765432"
|
||
},
|
||
"emisor": {
|
||
"nif": "A12345678",
|
||
"nombre": "EMPRESA EJEMPLO SL"
|
||
},
|
||
"sistema": {
|
||
"nombre": "Mi Software",
|
||
"nif_proveedor": "A12345678",
|
||
"version": "1.0.0"
|
||
}
|
||
}
|
||
```
|
||
|
||
### Mapeo Dolibarr → VeriFactu
|
||
|
||
| Dolibarr | VeriFactu |
|
||
|---|---|
|
||
| `invoice.number` | `num_serie` |
|
||
| `invoice.date` | `fecha_expedicion` (ISO → dd-mm-yyyy) |
|
||
| `invoice.notePublic` | `descripcion` |
|
||
| `lines[].quantity × unitPrice` | calcula `base = total / (1 + rate/100)`, `cuota = total - base` |
|
||
| `lines[].taxRate` | agrupa por tipo → `iva[].tipo` |
|
||
| `client.name` | `destinatario.nombre` |
|
||
| `client.vatNumber` | `destinatario.nif` |
|
||
| suma de líneas | `importe_total` (calculado automáticamente) |
|
||
| `emisor.nif` | `emisor_nif` |
|
||
| `emisor.nombre` | `emisor_nombre` |
|
||
|
||
> Los totales (`totalHt`, `totalTax`, `total`) **no se envían** — se calculan a partir de las líneas. Esto evita inconsistencias y permite validar que los números cuadran.
|
||
|
||
---
|
||
|
||
## Añadir un nuevo formato
|
||
|
||
1. Crear carpeta `internal/formats/miformato/format.go`
|
||
2. Implementar la interfaz `formats.Transformer`:
|
||
|
||
```go
|
||
package miformato
|
||
|
||
import (
|
||
"encoding/json"
|
||
"VerifactuMidAPI/internal/formats"
|
||
)
|
||
|
||
func init() {
|
||
formats.Register(&Transformer{})
|
||
}
|
||
|
||
type Transformer struct{}
|
||
|
||
func (t *Transformer) Name() string { return "miformato" }
|
||
|
||
func (t *Transformer) Transform(raw json.RawMessage) (*formats.TransformResult, error) {
|
||
// Parsear JSON de entrada
|
||
// Validar
|
||
// Devolver TransformResult
|
||
}
|
||
```
|
||
|
||
3. Importar en `main.go`:
|
||
|
||
```go
|
||
import _ "VerifactuMidAPI/internal/formats/miformato"
|
||
```
|
||
|
||
La detección es automática: el primer formato que pueda parsear el JSON se usa.
|