Crear proveedor

POST /api/common/compras/proveedores V4

Descripción

Endpoint para crear un nuevo proveedor en el sistema.

Parámetros de entrada

Parámetro	Tipo	Requerido	Descripción
codigoEmpresa	int	✅	Obligatorio si el cliente es multiempresa

Campos obligatorios *

new El código de empresa ya no es necesario proporcionarlo

Campo	Tipo	Requerido	Descripción
razonSocial	string	✅	Razón social del proveedor
cifDni	string	✅	CIF o DNI del proveedor
...		❌	Resto de campos opcionales

Note

El campo codigoClienteProveedor no debe enviarse en la solicitud. Se asigna automáticamente mediante un contador interno al crear el registro.

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

# Crear proveedor
curl -X POST "https://api.tandem.com/api/common/compras/proveedores" \
  -H "Authorization: Bearer tu_access_token"
  -H "Content-Type: application/json"
  -d '{
    "razonSocial": "Proveedor de prueba",
    "cifDni": "12345678Z",
    ...
  }'

Cuerpo de la petición

{
  "razonSocial": "string",
  "razonSocial2": "string",
  "nombre": "string",
  "domicilio": "string",
  "cargo1": "string",
  "nombre1": "string",
  "cargo2": "string",
  "nombre2": "string",
  "codigoCuenta": "string",
  "cifDni": "string",
  "cifEuropeo": "string",
  "codigoSigla": "string",
  "viaPublica": "string",
  "numero1": "string",
  "numero2": "string",
  "escalera": "string",
  "piso": "string",
  "puerta": "string",
  "letra": "string",
  "codigoPostal": "string",
  "codigoMunicipio": "string",
  "municipio": "string",
  "colaMunicipio": "string",
  "codigoProvincia": "string",
  "provincia": "string",
  "codigoNacion": 0,
  "nacion": "string",
  "telefono": "string",
  "telefono2": "string",
  "telefono3": "string",
  "fax": "string",
  "codigoTransaccion": 0,
  "codigoRetencion": 0,
  "deducible": 0,
  "codigoIva": 0,
  "mediacion": 0,
  "exclusion347": 0,
  "numeroPlazos": 0,
  "diasPrimerPlazo": 0,
  "diasEntrePlazos": 0,
  "diasFijos1": 0,
  "diasFijos2": 0,
  "diasFijos3": 0,
  "inicioNoPago": 0,
  "finNoPago": 0,
  "controlarFestivos": 0,
  "diasRetroceso": 0,
  "mesesComerciales": 0,
  "remesaHabitual": "string",
  "codigoTipoEfecto": 0,
  "email1": "string",
  "email2": "string",
  "codigoCategoriaCliente_": "string",
  "idDelegacion": "string",
  "codigoMotivoBajaClienteLc": "string",
  "codigoDepartamento": "string",
  "codigoCanal": "string",
  "codigoBanco": "string",
  "codigoAgencia": "string",
  "dc": "string",
  "ccc": "string",
  "iban": "string",
  "codigoCondiciones": 0,
  "idProcesoIME": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "movIdentificadorIME": "string",
  "statusTraspasadoIME": 0,
  "tipoImportacionIME": 0,
  "tipoPlanCuentaIME": 0,
  "contrapartida": "string",
  "codigoCuentaImpagado": "string",
  "codigoCuentaEfecto": "string",
  "comentarios": "string",
  "codigoTerritorio": 0,
  "codigoIdioma_": "string",
  "tarifaPrecio": 0,
  "descuento": 0,
  "rappel": 0,
  "prontoPago": 0,
  "financiacion": 0,
  "codigoComisionista": 0,
  "tarifaDescuento": 0,
  "siglaNacion": "string",
  "marcaMenorSinNif": 0,
  "personaFisicaJuridica": "string",
  "siglaNacionRepresentante": "string",
  "cifDniRepresentante": "string",
  "nombreRepresentante": "string",
  "tipoDocumentoPersona": 0,
  "tipoCif": "string",
  "motivoBajaClienteLc": "string",
  "puntosSR": 0,
  "tarjetaSR": "string",
  "domicilio2": "string",
  "cuentaProvision": "string",
  "codigoTransportista": 0,
  "formadePago": "string",
  "observacionesCliente": "string",
  "codigoTipoClienteLc": "string",
  "tipoCliente": "string",
  "codigoActividadLc": "string",
  "actividad": "string",
  "indicadorIva": "string",
  "codigoRuta_": "string",
  "nombreEmpleado": "string",
  "primerApellidoEmpleado": "string",
  "segundoApellidoEmpleado": "string",
  "sysTick": 0,
  "idCliente": "string",
  "riesgoMaximo": 0,
  "plazoMedioPCMA": 0,
  "criterioIvaIME": 0,
  "referenciaMandato": "string",
  "comision": 0,
  "codigoZona": 0,
  "bloqueoAlbaran": 0,
  "idProveedor": "string",
  "codigoSeccion": "string",
  "codigoSector_": "string",
  "codigoProyecto": "string",
  "codigoCadena_": "string",
  "bajaEmpresaLc": 0,
  "fechaBajaLc": "2025-06-20T10:13:04.011Z",
  "grupoIva": 0,
  "envioEFactura": 0,
  "emailEnvioEFactura": "string",
  "seriePedido_": "string",
  "serieAlbaran_": "string",
  "camposAdicionales": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  }
}