> For the complete documentation index, see [llms.txt](https://developers.admintotal.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.admintotal.com/api/centros-de-responsabilidad.md).

# Centros de responsabilidad

Consultar y crear Centros de Responsabilidad disponibles en Admintotal.

## Endpoints disponibles

<table><thead><tr><th width="101.54296875">Method</th><th width="602.546875">Endpoint</th></tr></thead><tbody><tr><td> <mark style="color:blue;"><strong>GET</strong></mark> </td><td>Obtiene la lista de centros de responsabilidad<br><code>https://{clave}.admintotal.com/api/v2/centros_responsabilidad/</code></td></tr><tr><td> <mark style="color:blue;"><strong>GET</strong></mark> </td><td>Obtiene un centro específico<br><code>https://{clave}.admintotal.com/api/v2/centros_responsabilidad/:id/</code></td></tr><tr><td> <mark style="color:green;"><strong>POST</strong></mark> </td><td>Crea un nuevo centro de responsabilidad<br><code>https://{clave}.admintotal.com/api/v2/centros_responsabilidad/</code></td></tr></tbody></table>

## Obtiene la lista de centros de responsabilidad

&#x20;<mark style="color:blue;">**GET**</mark> `https://{clave}.admintotal.com/api/v2/centros_responsabilidad/`

{% tabs %}
{% tab title="Headers" %}

| Name         | Type   | Description           |
| ------------ | ------ | --------------------- |
| Api-key      | string | Toke de autenticacion |
| {% endtab %} |        |                       |

{% tab title="200 OK" %}

<pre class="language-json"><code class="lang-json">"count": 8,
    "next": "http://{clave}.admintotal.com/api/v2/entradas_almacen/",
<strong>    "previous": null,
</strong>    "results": [
        {
            "id": 1,
            "numero": "001",
            "nombre": "SURSAL EJEMPLO",
            "padre": "SUCURSAL PADRE",
            "tipo": "CeCo",
            "responsable": "JUAN PEREZ"
        }
    ]
}
</code></pre>

{% endtab %}
{% endtabs %}

## Obtener un centro de responsabilidad.

<mark style="color:blue;">**GET**</mark> `https://{clave}.admintotal.com/api/v2/centros_responsabilidad/:id/`

{% tabs %}
{% tab title="Headers" %}

| Name         | Type   | Description           |
| ------------ | ------ | --------------------- |
| Api-key      | string | Toke de autenticacion |
| {% endtab %} |        |                       |

{% tab title="200 OK" %}

```json
{
    "id": 1,
    "numero": "001",
    "nombre": "SURSAL EJEMPLO",
    "padre": "SUCURSAL PADRE",
    "tipo": "CeCo",
    "responsable": "JUAN PEREZ"
}
```

{% endtab %}
{% endtabs %}

### Campos de respuesta

{% hint style="info" %}
Algunos campos utilizan valores distintos entre la solicitud y la respuesta.\
En la solicitud, `padre`, `tipo` y `responsable` reciben identificadores internos. \
En la respuesta, estos campos se representan mediante valores descriptivos para facilitar su lectura.
{% endhint %}

<table><thead><tr><th width="127.65625">Name</th><th width="100.640625">Type</th><th>Description</th><th width="149.56640625">Values</th></tr></thead><tbody><tr><td><code>id</code></td><td>integer</td><td>Identificador único del centro de responsabilidad.</td><td>—</td></tr><tr><td><code>numero</code></td><td>string</td><td>Número o código asignado al centro de responsabilidad.</td><td>—</td></tr><tr><td><code>nombre</code></td><td>string</td><td>Nombre asignado al centro de responsabilidad.</td><td>—</td></tr><tr><td><code>padre</code></td><td>string</td><td>Centro de responsabilidad asignado como padre al centro actual.</td><td>—</td></tr><tr><td><code>tipo</code></td><td>string</td><td>Tipo de Centro de responsabilidad.</td><td><code>1</code> = CeCo<br><code>2</code> = CeBe</td></tr><tr><td><code>responsable</code></td><td>string</td><td>Responsable al centro de responsabilidad.</td><td>—</td></tr></tbody></table>

***

## Crear un centro de responsabilidad.

<mark style="color:green;">**POST**</mark>  `https://{clave}.admintotal.com/api/v2/centros_responsabilidad/`&#x20;

{% tabs %}
{% tab title="Headers" %}

| Name         | Type   | Description           |
| ------------ | ------ | --------------------- |
| Api-key      | string | Toke de autenticacion |
| {% endtab %} |        |                       |

{% tab title="201 Created" %}

```json
{
    "id": 187,
    "numero": "002",
    "nombre": "SURSAL CREADA EJEMPLO",
    "padre": "SUCURSAL PADRE",
    "tipo": "CeBe",
    "responsable": "Pedro López"
}
```

{% endtab %}
{% endtabs %}

### Campos de la solicitud

{% hint style="info" %}
Algunos campos utilizan valores distintos entre la solicitud y la respuesta.\
En la solicitud, `padre`, `tipo` y `responsable` reciben identificadores internos. \
En la respuesta, estos campos se representan mediante valores descriptivos para facilitar su lectura.
{% endhint %}

<table><thead><tr><th width="127.65625">Name</th><th width="100.640625">Type</th><th width="115.3046875">Required</th><th>Description</th></tr></thead><tbody><tr><td><code>numero</code></td><td>string</td><td>Si</td><td>Número o código asignado al centro de responsabilidad.</td></tr><tr><td><code>nombre</code></td><td>string</td><td>Si</td><td>Nombre asignado al centro de responsabilidad.</td></tr><tr><td><code>padre</code></td><td>string</td><td>No</td><td>Centro de responsabilidad asignado como padre al centro actual.</td></tr><tr><td><code>tipo</code></td><td>string</td><td>Si</td><td>Tipo de Centro de responsabilidad.</td></tr><tr><td><code>responsable</code></td><td>string</td><td>No</td><td>Responsable al centro de responsabilidad.</td></tr></tbody></table>

***

## Errores HTTP

Posibles códigos de error que puedes encontrar al consumir este recurso.

<table><thead><tr><th width="170.59765625"></th><th width="128.9375"></th><th width="215.58984375"></th><th></th></tr></thead><tbody><tr><td><h4><mark style="color:$warning;"><code>400</code></mark> </h4><p>Solicitud invalida</p></td><td><h4><mark style="color:$danger;"><code>403</code></mark> </h4><p>Sin permiso</p></td><td><h4><mark style="color:$danger;"><code>404</code></mark><br></h4><p>Registro no encontrado</p></td><td><h4><mark style="color:$danger;"><code>500</code></mark> </h4><p>Error interno del servidor</p></td></tr></tbody></table>