Crear documento

POST /api/common/documentos V4

Descripción

Endpoint para crear un documento. Se debe incluir como parámetros los datos mínimos obligatorios del documento y al menos una linea del documento. La linea tiene sus propios datos obligatorios.

Parámetros de entrada

Parámetro	Tipo	Requerido	Descripción
codigoEmpresa	int	✅ (si es multiempresa)	Código de la empresa

Campos obligatorios *

Cabecera:

Campo	Tipo	Requerido	Descripción
codigoDocumentoLc	string	✅	Tipo de documento
ejercicioDocumento	int	✅	Ejercicio del documento
serieDocumento	string	✅	Serie del documento
fechaDocumento	string	✅	Fecha del documento (yyyy-MM-dd)
codigoCliente / codigoProveedor	string	✅	Cliente (venta) o Proveedor (compra)
lineasDocumento	array	✅	Líneas del documento

Líneas (lineasDocumento):

Campo	Tipo	Requerido	Descripción
orden	int	✅	Orden de la línea
codigoArticulo	string	✅	Código del artículo
unidades	int	✅	Unidades
...		❌	Resto de campos opcionales

Note

El precio no es un campo obligatorio, si no se indica, cogerá el precio que tenga el artículo. Si se asigna uno, se usará ese precio para la línea del documento sobreescribiendo el valor por defecto.

Note

El campo codigoDocumentoLc puede ser:

ALC: Albarán de venta.

ALP: Albarán de compra.

FAC: Factura de venta.

FAP: Factura de compra.

FPC: Contrato de venta.

FPP: Contrato de compra.

OFE: Oferta de venta.

OFC: Oferta de compra.

PVE: Pedido de venta.

PCO: Pedido de compra.

TCK: Ticket.

Note

Si el cliente tiene atributos personalizados que no están por defecto en la tabla de Sage, puede incluirlos en el apartado camposAdicionales.

"camposAdicionales": {
  "additionalProp1": "valor1",
  "additionalProp2": "valor2",
  "additionalProp3": "valor3"
}

Sólo hay que modificiar ‘additionalPropX’ por el nombre del campo personalizado y ‘valorX’ por el valor que se quiera asignar.

Ejemplo con filtros

curl -X POST "https://api.tandem.com/api/common/documentos" \
  -H "Authorization: Bearer tu_access_token" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "codigoDocumentoLc": "PVE",
      "ejercicioDocumento": 2026,
      "serieDocumento": "ZZ",
      "fechaDocumento": "2026-05-11",
      "codigoCliente": "000098",
      "lineasDocumento": [
        {
          "orden": 5,
          "codigoArticulo": "002_043",
          "unidades": 5
        }
      ]
    }
  ]'

Cuerpo de la petición

[
  {
    "codigoDocumentoLc": "PVE",
    "ejercicioDocumento": 2026,
    "serieDocumento": "ZZ",
    "fechaDocumento": "2026-05-11",
    "codigoCliente": "000098",
    "lineasDocumento": [
      {
        "orden": 5,
        "codigoArticulo": "002_043",
        "unidades": 5
      }
    ]
  }
]

Los campos de cabecera y línea son los únicos obligatorios. El resto son opcionales y se pueden incluir según necesidad. Las líneas no necesitan repetir codigoDocumentoLc, ejercicioDocumento, serieDocumento ni fechaDocumento, ya que se heredan de la cabecera.