> ## Documentation Index
> Fetch the complete documentation index at: https://tech.sedierp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Validación existencia (proveedor)

El servicio permite validar si un tercero con un tipo y número de documento ya está registrado en la empresa, en línea en formato JSON.

Se utiliza en el formulario de inscripción de proveedores del portal, antes de llamar al servicio de [registro de proveedor](https://tech.sedierp.com/registro-de-proveedor.md).

El método de solicitud es POST y no requiere autenticación.

## Prerequisitos

Antes de realizar la validación, se debe contar con los siguientes datos:

* Código del ambiente de dominio de la empresa (AmbienteDominioID) obtenido del servicio de [ambiente de inicio de sesión](https://tech.sedierp.com/ambiente-de-inicio-de-sesion.md)
* Código del tipo de documento (TipoDocumentoID) obtenido del servicio de [tipos de documentos](https://tech.sedierp.com/tipos-de-documentos.md)

## Validar existencia de proveedor

**Request URL:** [https://portal.sedierp.com/API/api/Proveedores/ValidarExisteProveedorConsultar](https://portal.sedierp.com/API/api/Proveedores/ValidarExisteProveedorConsultar)\
**Tipo:** POST \
**Content Type:** application/json

**AmbienteDominioID** `int` *required*

Código único del ambiente de dominio de la empresa (ID).

**TipoDocumentoID** `int` *required*

Código del tipo de documento de identificación del tercero (ID).

**Documento** `string` *required*

Número de documento de identificación del tercero. La comparación ignora los espacios.

```bash theme={null}
curl --location 'https://portal.sedierp.com/API/api/Proveedores/ValidarExisteProveedorConsultar' \
--header 'Content-Type: application/json' \
--data '{
	"AmbienteDominioID": 12,
	"TipoDocumentoID": 6,
	"Documento": "900123456"
}'
```

### Respuesta

El resultado de la validación se lee en el campo `total`:

* **`total` mayor que 0:** existe un tercero de la empresa con ese tipo y número de documento (sea o no proveedor).
* **`total` igual a 0:** no existe; se puede registrar con el servicio de [registro de proveedor](https://tech.sedierp.com/registro-de-proveedor.md).

**total** `int`

Cantidad de terceros de la empresa encontrados con el tipo y número de documento enviados.

**rows** `array`

Un elemento por cada tercero encontrado. Actualmente los elementos llegan sin campos (objetos vacíos).

**result** `int`

Resultado de la operación: 1 cuando la consulta es correcta.

Si falta alguno de los parámetros obligatorios, el servicio responde HTTP 400 con el detalle de la validación. Si el `AmbienteDominioID` no existe, responde `total` igual a 0.

```json Request theme={null}
{
  "AmbienteDominioID": 12,
  "TipoDocumentoID": 6,
  "Documento": "900123456"
}
```

```json Existe theme={null}
{
    "total": 1,
    "rows": [
        {}
    ],
    "result": 1
}
```

```json No existe theme={null}
{
    "total": 0,
    "rows": [],
    "result": 1
}
```

```json Error theme={null}
{
    "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
    "title": "One or more validation errors occurred.",
    "status": 400,
    "errors": {
        "Documento": [
            "The Documento field is required."
        ]
    },
    "traceId": "00-6f1c2a9e4b7d3f8a0c5e9b2d1a4f7c3e-8b2d4f6a1c3e5b7d-00"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.