> ## 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.

# Consulta detallada

El servicio permite verificar si una nota crédito existe en la empresa a partir de su identificador único (UniqueID), en línea en formato JSON.

Se utiliza para validar el identificador de la nota crédito antes de descargar sus archivos con el servicio de [generación del archivo ZIP](https://tech.sedierp.com/descarga-de-archivo-zip.md).

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

## Prerequisitos

Antes de realizar la consulta de la nota crédito, se debe contar con los siguientes datos:

* Identificador único de la nota crédito (UniqueID) obtenido del servicio de [notas crédito](https://tech.sedierp.com/consulta-general-notas-credito.md)
* 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)

## Consultar nota crédito

**Request URL:** [https://portal.sedierp.com/API\_FAC/api/NotasCredito/NotasCreditoUniqueIDConsultar](https://portal.sedierp.com/API_FAC/api/NotasCredito/NotasCreditoUniqueIDConsultar)\
**Tipo:** POST \
**Content Type:** application/json

**UniqueID** `GUID` *required*

Identificador único de la nota crédito.

**AmbienteDominioID** `int` *required*

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

```bash theme={null}
curl --location 'https://portal.sedierp.com/API_FAC/api/NotasCredito/NotasCreditoUniqueIDConsultar' \
--header 'Content-Type: application/json' \
--data '{
	"UniqueID": "2d6ab937-3b29-4b79-89d3-6d9b541711bb",
	"AmbienteDominioID": 12
}'
```

### Respuesta

Si la nota crédito existe en la empresa del ambiente indicado, el servicio retorna un registro con su identificador único. Si no existe, o el `AmbienteDominioID` no corresponde a ninguna empresa, retorna `rows` vacío.

**UniqueID** `GUID`

Identificador único de la nota crédito encontrada.

> [!NOTE]
>
> Si falta `UniqueID` o `AmbienteDominioID`, o no tienen el formato correcto, el servicio responde HTTP 400 con el detalle de la validación.

```json Request theme={null}
{
  "UniqueID": "2d6ab937-3b29-4b79-89d3-6d9b541711bb",
  "AmbienteDominioID": 12
}
```

```json Exitosa theme={null}
{
    "total": 1,
    "rows": [
        {
            "UniqueID": "2d6ab937-3b29-4b79-89d3-6d9b541711bb"
        }
    ],
    "result": 1
}
```

```json Sin resultados 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": {
        "AmbienteDominioID": [
            "The AmbienteDominioID field is required."
        ]
    },
    "traceId": "00-6f1c2e8a9b4d4f0e8a1b2c3d4e5f6a7b-1a2b3c4d5e6f7a8b-00"
}
```


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