Obtener proveedor mediante CIF/DNI

GET /api/common/compras/proveedores/cifdni/{cifdni} V4

Descripción

Endpoint para obtener un proveedor mediante su CIF/DNI

Permite especificar los campos que se quieren devolver. Si no se especifica ningún campo, se devolverán todos.

Parámetros de consulta

Parámetro	Tipo	Requerido	Descripción
cifDni	string	✅	Código del proveedor
campos	string	❌	Si rellenas este campo, solo devolverá los campos que indiques. Puedes añadir más de uno separados por comas
codigoEmpresa	int	✅ (si es multiempresa)	Código de la empresa

Ejemplo con filtros

# Obtener proveedor por ID
curl -X GET "https://api.tandem.com/api/common/compras/proveedores/cifdni/12345678Z" \
  -H "Authorization: Bearer tu_access_token"

Respuesta exitosa (200)

{
  "success": true,
  "message": "Éxito",
  "result": {
    "idDelegacion": "",
    "codigoProveedor": "000001",
    "siglaNacion": "ES",
    "cifDni": "1234567",
    "cifEuropeo": "ES1234567",
    "razonSocial": "EMPRESA DEMOSTRACION TANDEM, SL",
    "razonSocial2": "",
    "nombre": "EMPRESA DEMOSTRACION TANDEM, SL",
    "domicilio": "RB/Cataluña,21,E-1-3",
    "domicilio2": "",
    "actividad": "",
    "cargo1": "",
    "nombre1": "",
    "cargo2": "",
    "nombre2": "",
    "cargo3": "",
    "nombre3": "",
    "tipoProveedor": "",
    "marca": "",
    "observacionesProveedor": "",
    "comentarios": "",
    "codigoContable": "400000001",
    "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": 0,
    "indicadorIva": "I",
    "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": "RB",
    "viaPublica": "Cataluña",
    "numero1": "21",
    "numero2": "",
    "escalera": "E",
    "piso": "1",
    "puerta": "3",
    "letra": "",
    "codigoPostal": "08080",
    "codigoMunicipio": "08019",
    "municipio": "BARCELONA",
    "colaMunicipio": "",
    "codigoProvincia": "08",
    "provincia": "BARCELONA",
    "codigoNacion": 108,
    "nacion": "ESPAÑA",
    "telefono": "932451111",
    "telefono2": "932451112",
    "telefono3": "",
    "fax": "932451113",
    "email1": "EmpPruebas@mail.es",
    "email2": "",
    "bajaEmpresaLc": 0,
    "riesgoMaximo": 0,
    "referenciaEdi_": "",
    "referenciadelCliente": "",
    "codigoNaturaleza": "",
    "codigoTransporte": "",
    "codigoPuerto": "",
    "codigoRegimenEstadistico": "",
    "retencionConIva_": 0,
    "codigoContableANT_": "",
    "condicionExportacion_": "",
    "codigoExportacion_": "",
    "idProveedor": "cb78d43d-891b-443c-a1a4-efedab6f2de1",
    "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": ""
  }
}