Crear documento
Descripción
Section titled “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
Section titled “Parámetros de entrada”| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
codigoEmpresa | int | ✅ (si es multiempresa) | Código de la empresa |
Campos obligatorios *
Section titled “Campos obligatorios *”| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
codigoDocumentoLc | string | ✅ | Codigo del documento |
ejercicioDocumento | int | ✅ | Ejercicio del documento |
serieDocumento | string | ✅ | Serie del documento |
fechaDocumento | string | ✅ | Fecha del documento (yyyy-MM-dd) |
codigoCliente | string | ✅ | Codigo del cliente |
razonSocial | string | ✅ | Razón social |
lineasDocumento | array | ✅ | Lineas del documento |
codigoDocumentoLc | string | ✅ | Codigo del documento |
ejercicioDocumento | int | ✅ | Ejercicio del artículo |
serieDocumento | string | ✅ | Serie del documento |
orden | int | ✅ | Orden |
fechaDocumento | string | ✅ | Fecha del documento |
codigoArticulo | string | ✅ | Código del artículo |
descripcionArticulo | string | ✅ | Descripción del artículo |
unidades | int | ✅ | Unidades |
precio | int | ✅ | Precio |
... | ❌ | Resto de campos |
Ejemplo con filtros
Section titled “Ejemplo con filtros”# Crear documentocurl -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", "descripcionArticulo": "Descripcion del articulo", "unidades": 1, "precio": 10, ... } ], ... }'Cuerpo de la petición
Section titled “Cuerpo de la petición”[ { "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" } }]