Buscar proveedores

GET /api/common/compras/proveedores/buscarproveedor?page={page}&pageSize={pageSize} V4

Descripción

Endpoint para buscar proveedores de forma avanzada.

Permite realizar búsquedas dinámicas indicando:

La columna sobre la que buscar (columnaBusqueda)
El valor a buscar (valorBusqueda)
El tipo de búsqueda (tipoBusqueda)

Además, se pueden limitar los campos devueltos mediante el parámetro campos.

Parámetros de consulta

Parámetro	Tipo	Requerido	Descripción
`page`	int	✅	Número de página
`pageSize`	int	✅	Cantidad de elementos por página
`campos`	string	❌	Lista de campos separados por comas
`columnaBusqueda`	string	❌	Campo sobre el que realizar la búsqueda
`valorBusqueda`	string	❌	Valor a buscar
`tipoBusqueda`	enum	❌	Puedes hacer búsquedas exactas, parciales o que no contengan ese o eso valores.
`codigoEmpresa`	int	✅ (si es multiempresa)	Código de la empresa

El tipoBusqueda puede ser:

Ejemplos de uso

🔍 Búsqueda por nombre de proveedor

curl -X 'GET' \
  'https://api.tandem.com/api/common/compras/proveedores/buscarproveedor?page=1&pageSize=10&columnaBusqueda=razonsocial&valorBusqueda=proveedor%20prueba&tipoBusqueda=Completa&codigoEmpresa=9999' \
  -H 'accept: */*' \
  -H "Authorization: Bearer tu_access_token"

Respuesta exitosa (200)

{
  "success": true,
  "message": "Proveedores encontrados",
  "result": {
    "data": [
      {
        "codigoEmpresa": 9999,
        "idDelegacion": "",
        "codigoProveedor": "005062",
        "siglaNacion": "ES",
        "cifDni": "A4152633",
        "cifEuropeo": "ESA4152633",
        "razonSocial": "proveedor prueba",
        "razonSocial2": "",
        "nombre": "proveedor prueba",
        "domicilio": "",
        "domicilio2": "",
        "actividad": "",
        "cargo1": "",
        "nombre1": "",
        "cargo2": "",
        "nombre2": "",
        "cargo3": "",
        "nombre3": "",
        "tipoProveedor": "",
        "marca": "",
        "observacionesProveedor": "",
        "comentarios": "",
        "codigoContable": "400005062",
        "codigoDefinicion_": "",
        "codigoCondiciones": 0,
        "formadePago": "",
        "codigoBanco": "",
        "codigoAgencia": "",
        "dc": "",
        "ccc": "",
        "iban": "",
        "bloqueoPedido": 0,
        "bloqueoCompra": 0,
        "domicilioRecibo": 0,
        "codigoCliente": "",
        "clienteVenta": "",
        "codigoProyecto": "",
        "codigoSeccion": "",
        "codigoDepartamento": "",
        "almacenDeposito": "",
        "codigoIdioma_": "",
        "codigoDivisa": "",
        "codigoCanal": "",
        "codigoZona": 0,
        "codigoTransportista": 0,
        "tipoPortes": "D",
        "tarifaPrecio": 0,
        "tarifaDescuento": 0,
        "grupoIva": 4,
        "indicadorIva": "E",
        "mascaraOferta_": "",
        "mascaraPedido_": "",
        "mascaraAlbaran_": "",
        "mascaraTalones_": "",
        "mascaraFactura_": "",
        "serieOferta_": "",
        "seriePedido_": "",
        "serieAlbaran_": "",
        "agruparAlbaranes": 0,
        "agruparAbonos": 0,
        "mantenerCambio_": -1,
        "financiacionSobreBase_": 0,
        "%Descuento": 0,
        "%ProntoPago": 0,
        "%Retencion": 0,
        "%Rappel": 0,
        "%Financiacion": 0,
        "codigoSigla": "",
        "viaPublica": "",
        "numero1": "",
        "numero2": "",
        "escalera": "",
        "piso": "",
        "puerta": "",
        "letra": "",
        "codigoPostal": "",
        "codigoMunicipio": "",
        "municipio": "",
        "colaMunicipio": "",
        "codigoProvincia": "",
        "provincia": "",
        "codigoNacion": 108,
        "nacion": "ESPAÑA",
        "telefono": "",
        "telefono2": "",
        "telefono3": "",
        "fax": "",
        "email1": "",
        "email2": "",
        "bajaEmpresaLc": 0,
        "fechaBajaLc": null,
        "riesgoMaximo": 0,
        "referenciaEdi_": "",
        "referenciadelCliente": "",
        "codigoNaturaleza": "",
        "codigoTransporte": "",
        "codigoPuerto": "",
        "codigoRegimenEstadistico": "",
        "retencionConIva_": 0,
        "codigoContableANT_": "",
        "condicionExportacion_": "",
        "codigoExportacion_": "",
        "fechaNacimiento": null,
        "idProveedor": "7d4bf8ab-cdce-429d-a513-d2e63ce781cb",
        "social1": "",
        "social2": "",
        "social3": "",
        "social4": "",
        "telefonoAccion": "Defecto",
        "telefono2Accion": "Defecto",
        "telefono3Accion": "Defecto",
        "social1Accion": "Defecto",
        "social2Accion": "Defecto",
        "social3Accion": "Defecto",
        "social4Accion": "Defecto",
        "excluirPorLOPDLc": 0,
        "statusWF": 0,
        "sistemaAutofacturas": 1,
        "codigoEpigrafeBizkaia": ""
      }
    ],
    "totalRecords": 1,
    "totalPages": 1,
    "currentPage": 1,
    "pageSize": 10
  }
}