# Get

Para consultar los datos de un proveedor podemos generar la siguiente solicitud con el archivo `payload.json`:

```
curl "https://agents.boolfy.com/api/suppliers/get" \ 
    -H "Authorization: Bearer BOOLFY_BEARER_KEY" \
    -H "Content-Type: application/json" \
    -d @payload.json
```

El archivo `payload.json` debe tener el siguiente formato:

```json
{
    "TaxCode": "30123456780"
}
```

Detallamos en forma completa los campos de la solicitud:

<table><thead><tr><th width="221">Campo</th><th>Descripción</th></tr></thead><tbody><tr><td>TaxCode</td><td>Especifica el identificador fiscal del proveedor en el país que estas trabajando. Algunos de estos pueden ser: CUIT, CUIL, RFC y/o CNPJ entre otros.</td></tr></tbody></table>

### Respuesta

La respuesta exitosa para la consulta de datos del documentos es:

```json
{
    "code": 200,
    "msg": null,
    "response": "[{\"Name\":\"Empresa SRL",\"TaxCode\":\"30123456780\"...}]"
}
```

Detallamos el contenido del campo Response:

<table><thead><tr><th width="221">Campo</th><th>Descripción</th></tr></thead><tbody><tr><td>Name</td><td>Especifica el nombre o razon social del proveedor</td></tr><tr><td>Brand</td><td>Especifica el nombre de fantasía o marca comercial del proveedor</td></tr><tr><td>Country</td><td>Especifica el país de origen del proveedor</td></tr><tr><td>TaxType</td><td>Especifica el tipo de inscripción del proveedor</td></tr><tr><td>TaxCode</td><td>Especifica el identificador fiscal del país de origen del proveedor</td></tr><tr><td>VatType</td><td>Especifica el tipo de inscripción frente a impuestos del proveedor.</td></tr><tr><td>ExternalCode</td><td>Especifica el identificador en tu plataforma del proveedor</td></tr><tr><td>Email</td><td>Especifica el email del proveedor</td></tr><tr><td>Phone</td><td>Especifica el teléfono del proveedor</td></tr><tr><td>Notes</td><td>Especifica las notas que tiene adheridas el proveedor</td></tr><tr><td>State</td><td>Especifica el estado del proveedor. Ver <a href="/pages/VirGu75OHC7cdnnmO6aP#estados-de-revision">Estados de revisión</a></td></tr><tr><td>Addresses</td><td>Especifica el listado de direcciones del proveedor. Ver <a href="#address">Address</a></td></tr></tbody></table>

### Address

Detallamos el contenido de las direcciones:

<table><thead><tr><th width="222">Campo</th><th>Descripción</th></tr></thead><tbody><tr><td>Name</td><td>Es el nombre del domicilio</td></tr><tr><td>Country</td><td>Especifica el país del domicilio</td></tr><tr><td>State</td><td>Especifica el estado o provincia del domicilio</td></tr><tr><td>City</td><td>Especifica la ciudad del domicilio</td></tr><tr><td>Street</td><td>Especifica el nombre de la calle o avenida del domicilio</td></tr><tr><td>Number</td><td>Especifica la altura o número de puerta del domicilio</td></tr><tr><td>Floor</td><td>En caso de existir, especifica el piso del domicilio</td></tr><tr><td>Department</td><td>En caso de existir, especifica el departamento del domicilio</td></tr><tr><td>Tower</td><td>En caso de existir, especifica la torre del domicilio</td></tr><tr><td>ZipCode</td><td>Especifica el código postal del domicilio</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-agents-api.boolfy.com/suppliers/get.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.