Skip to content

Crear documento

POST /api/common/documentos V4

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ámetroTipoRequeridoDescripción
codigoEmpresaint✅ (si es multiempresa)Código de la empresa
CampoTipoRequeridoDescripción
codigoDocumentoLcstringCodigo del documento
ejercicioDocumentointEjercicio del documento
serieDocumentostringSerie del documento
fechaDocumentostringFecha del documento (yyyy-MM-dd)
codigoCliente\codigoProveedorstringCliente para doc. de venta, Proveedor para compra
lineasDocumentoarrayLineas del documento
codigoDocumentoLcstringCodigo del documento en la línea
ejercicioDocumentointEjercicio del artículo en la línea
serieDocumentostringSerie del documento en la línea
ordenintOrden
fechaDocumentostringFecha del documento en la línea
codigoArticulostringCódigo del artículo
unidadesintUnidades
...Resto de campos
Terminal window
# Crear documento
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": 2025,
"serieDocumento": "SER-001",
"fechaDocumento": "2025-06-19",
"codigoCliente": "CLI-001",
"razonSocial": "Razon Social",
"lineasDocumento": [
{
"codigoDocumentoLc": "PVE",
"ejercicioDocumento": 2025,
"serieDocumento": "SER-001",
"orden": 1,
"fechaDocumento": "2025-06-19",
"codigoArticulo": "ART-001"
"unidades": 1
...
}
],
...
}'
[
{
"idDelegacion": "string",
"codigoDocumentoLc": "string",
"ejercicioDocumento": 0,
"serieDocumento": "string",
"numeroDocumento": 0,
"fechaDocumento": "2025-10-27T11:58:17.881Z",
"codigoCliente": "string",
"codigoProveedor": "string",
"codigoCadena_": "string",
"siglaNacion": "string",
"cifDni": "string",
"cifEuropeo": "string",
"razonSocial": "string",
"razonSocialEnvios": "string",
"razonSocial2": "string",
"razonSocial2Envios": "string",
"nombre": "string",
"nombreEnvios": "string",
"domicilio": "string",
"domicilioEnvios": "string",
"domicilio2": "string",
"domicilio2Envios": "string",
"viaPublicaEnvios": "string",
"codigoPostal": "string",
"codigoPostalEnvios": "string",
"codigoMunicipio": "string",
"codigoMunicipioEnvios": "string",
"municipio": "string",
"municipioEnvios": "string",
"colaMunicipio": "string",
"colaMunicipioEnvios": "string",
"codigoProvincia": "string",
"codigoProvinciaEnvios": "string",
"provincia": "string",
"provinciaEnvios": "string",
"codigoNacion": 0,
"codigoNacionEnvios": 0,
"nacion": "string",
"nacionEnvios": "string",
"telefonoEnvios": "string",
"faxEnvios": "string",
"codigoCondiciones": 0,
"formadePago": "string",
"numeroPlazos": 0,
"diasPrimerPlazo": 0,
"diasEntrePlazos": 0,
"diasFijos1": 0,
"diasFijos2": 0,
"diasFijos3": 0,
"inicioNoPago": 0,
"finNoPago": 0,
"controlarFestivos": 0,
"diasRetroceso": 0,
"mesesComerciales": 0,
"codigoTransportistaEnvios": 0,
"tipoPortesEnvios": "string",
"codigoTransaccion": 0,
"codigoRetencion": 0,
"codigoTipoEfecto": 0,
"domicilioEnvio": 0,
"domicilioFactura": 0,
"domicilioRecibo": 0,
"codigoDefinicion_": "string",
"codigoContable": "string",
"remesaHabitual": "string",
"codigoBanco": "string",
"codigoAgencia": "string",
"dc": "string",
"ccc": "string",
"iban": "string",
"codigoTerritorio": 0,
"indicadorIva": "string",
"ivaIncluido": 0,
"grupoIva": 0,
"tarifaPrecio": 0,
"tarifaDescuento": 0,
"codigoComisionista": 0,
"codigoComisionista2_": 0,
"codigoComisionista3_": 0,
"codigoComisionista4_": 0,
"codigoZona": 0,
"codigoCanal": "string",
"codigoRuta_": "string",
"codigoProyecto": "string",
"codigoSeccion": "string",
"codigoDepartamento": "string",
"bloqueo": 0,
"statusAbono": 0,
"albaranValorado": 0,
"periodicidadFacturas": 0,
"agruparAlbaranes": 0,
"copiasAlbaran": 0,
"copiasFactura": 0,
"mascaraAlbaran_": "string",
"mascaraFactura_": "string",
"observacionesCliente": "string",
"observacionesDocumento": "string",
"observacionesFactura": "string",
"descuento": 0,
"prontoPago": 0,
"financiacion": 0,
"retencion": 0,
"rappel": 0,
"comision": 0,
"comision2_": 0,
"comision3_": 0,
"comision4_": 0,
"comisionSobreVenta_": 0,
"comisionSobreZona_": 0,
"suPedido": "string",
"codigoDivisa": "string",
"codigoIdioma_": "string",
"factorCambio": 0,
"mantenerCambio_": 0,
"bultos": 0,
"importePortes": 0,
"importePortesDivisa_": 0,
"importeCambio": 0,
"importeCambioViejo_": 0,
"codigoExportacion_": "string",
"condicionExportacion_": "string",
"observacionExportacion_": "string",
"observacionExportacion2_": "string",
"puertoOrigen_": "string",
"puertoDestino_": "string",
"ejercicioFacturaOriginal": 0,
"serieFacturaOriginal": "string",
"numeroFacturaOriginal": 0,
"referenciaEdi_": "string",
"codigoMotivoAbonoLc": "string",
"ejercicioAlbaranOriginalLc": 0,
"serieAlbaranOriginalLc": "string",
"numeroAlbaranOriginalLc": 0,
"importeACuentaA_": 0,
"importeACuentaADivisa_": 0,
"importeProvisiones": 0,
"importeProvisionesNF": 0,
"importeProvisionesDivisa": 0,
"importeProvisionesNFDivisa": 0,
"fechaInicio": "2025-10-27T11:58:17.881Z",
"fechaFormalizacion": "2025-10-27T11:58:17.881Z",
"codigoPeriodicidadPrecio": "string",
"codigoPeriodicidadPago": "string",
"tipoPagoContrato": 0,
"tipoFacturacion": 0,
"suFacturaNo": "string",
"fechaOperacion": "2025-10-27T11:58:17.881Z",
"capturarComisiones": 0,
"capturarPrecios": 0,
"rebajarStock": 0,
"renumerar": 0,
"generarEfectosFactura": 0,
"guiaContabilizacion": "string",
"forzarCeros": 0,
"idProcesoIME": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"movIdentificadorIME": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"statusTraspasadoIME": 0,
"tipoImportacionIME": 0,
"noFacturable": 0,
"numeroTerminalSR": 0,
"numeroTurnoSR": 0,
"fechaCreacion": "2025-10-27T11:58:17.881Z",
"horaCreacion": 0,
"esTicket": 0,
"documentoAGenerar": "string",
"estadoContrato": 0,
"claveOperacionFactura_": "string",
"manualoAlbaranes_": "string",
"ideFactura": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"ejercicioDocumentoLc": 0,
"serieDocumentoLc": "string",
"numeroDocumentoLc": 0,
"validar": 0,
"codigoActividad": "string",
"codigoCuenta": "string",
"importeSuplidos": 0,
"importeNeto": 0,
"importeLiquido": 0,
"baseRetencion": 0,
"importeRetencion": 0,
"serieAgrupacion_": "string",
"numeroFacturaInicial_": 0,
"numeroFacturaFinal_": 0,
"gastosAduana_": 0,
"codigoTipoDocumento": "string",
"pathUbicacion": "string",
"documentoConta": "string",
"importeDescuento": 0,
"importeDescuentoDivisa_": 0,
"importeRappel": 0,
"importeRappelDivisa_": 0,
"importeProntoPago": 0,
"importeProntoPagoDivisa_": 0,
"codigoElemento": "string",
"generaInmovilizado": 0,
"refClienteId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"idDocumento": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"sysTick": 0,
"criterioIva": 0,
"cuentaBanco": "string",
"fraRegistroIVA": 0,
"referenciaMandato": "string",
"suContrato": "string",
"importeCobroPago": 0,
"bancoCobroPago": "string",
"guiaCobroPago": "string",
"estado": 0,
"suPedidoWeb": 0,
"statusFacturado": 0,
"generarFacturaEntrega": 0,
"codigoTipoEfectoEntrega": 0,
"cuentaIngresoEntrega": "string",
"codigoArticuloEntrega": "string",
"tipoRectificativa": 0,
"baseImponibleOriginal": 0,
"cuotaIvaOriginal": 0,
"claseAbonoRectificativas": 0,
"recargoEquivalenciaOriginal": 0,
"contrapartidaEntradaRapida": "string",
"telefono": "string",
"eMail1": "string",
"lineasDocumento": [
{
"codigoDocumentoLc": "string",
"ejercicioDocumento": 0,
"serieDocumento": "string",
"numeroDocumento": 0,
"orden": 0,
"fechaDocumento": "2025-10-27T11:58:17.881Z",
"codigoArticulo": "string",
"codigoAlmacen": "string",
"almacenContrapartida": "string",
"partida": "string",
"descripcionArticulo": "string",
"descripcion2Articulo": "string",
"descripcionLinea": "string",
"codigodelCliente": "string",
"codigoFamilia": "string",
"codigoSubfamilia": "string",
"unidadMedida1_": "string",
"unidadMedida2_": "string",
"factorConversion_": 0,
"codigoProyecto": "string",
"codigoSeccion": "string",
"codigoDepartamento": "string",
"ivaIncluido": 0,
"bloqueoRebaje_": 0,
"acumulaEstadistica_": 0,
"codigoArancelario": "string",
"codigoDefinicion_": "string",
"codigoTransaccion": 0,
"ubicacion": "string",
"suPedido": "string",
"codigoComisionista": 0,
"codigoComisionista2_": 0,
"codigoComisionista3_": 0,
"codigoComisionista4_": 0,
"codigoColor_": "string",
"grupoTalla_": 0,
"codigoTalla01_": "string",
"grupoIva": 0,
"codigoIva": 0,
"formulaLote": 0,
"lote_": 0,
"tipoEnvase_": 0,
"codigoAgrupacion": 0,
"numeroAgrupaciones": 0,
"unidadesAgrupacion": 0,
"unidades": 0,
"unidades2_": 0,
"precio": 0,
"precioEnvase_": 0,
"precioRebaje": 0,
"descuento": 0,
"descuento2": 0,
"descuento3": 0,
"iva": 0,
"recargo": 0,
"baseCorreccion": 0,
"comision": 0,
"comision2_": 0,
"comision3_": 0,
"comision4_": 0,
"comisionSobreVenta_": 0,
"comisionSobreZona_": 0,
"pesoBrutoUnitario_": 0,
"pesoNetoUnitario_": 0,
"volumenUnitario_": 0,
"trataNumerosSerieLc": 0,
"tipoArticulo": "string",
"reservarStock_": 0,
"numeroSerieLc": "string",
"codigoDun14": "string",
"ediSellerNumber": "string",
"ediBatchNumber": "string",
"ediISBN": "string",
"ediSerialNumber": "string",
"ediEtiquetaEAN": "string",
"suplido": 0,
"codigoPerceptor": "string",
"fechaInicio": "2025-10-27T11:58:17.881Z",
"fechaFormalizacion": "2025-10-27T11:58:17.881Z",
"codigoPeriodicidadPrecio": "string",
"codigoPeriodicidadPago": "string",
"tipoPagoContrato": 0,
"partirPeriodos": 0,
"forzarCeros": 0,
"idProcesoIME": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"movIdentificadorIME": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"statusTraspasadoIME": 0,
"tipoImportacionIME": 0,
"codigoJefeVenta_": 0,
"codigoJefeZona_": 0,
"ejercicioOrigen": 0,
"serieOrigen": "string",
"numeroOrigen": 0,
"numeroOrdenEfecto": 0,
"idDocumento": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"idDocumentoLin": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"suContrato": "string",
"estado": 0,
"camposAdicionales": {
"additionalProp1": "string",
"additionalProp2": "string",
"additionalProp3": "string"
}
}
],
"camposAdicionales": {
"additionalProp1": "string",
"additionalProp2": "string",
"additionalProp3": "string"
}
}
]