# Administración del catálogo de propietarios
La autenticación puede hacerse con Id de sesión (ids) o con usuario (correo/teléfono) y contraseña (pwd), a través de parámetros en la URL o bien,
con el encabezado ```Authorization: Bearer p_ids```
La determinación de la base de datos del emisor, se realiza por medio del parámetro rfc o nic, se requiere uno de los dos, pero no ambos.
Parámetros generales
* ```p_rfc```. RFC del emisor
* ```p_nic```. NIC del emisor
* ```p_ids```. Identificador de sesión del usuario
* ```p_uid```. Identificador del usuario, correo o teléfono móvil
* ```p_pwd```. Contraseña correspondiente al p_uid
## Consultar propietarios
Obtiene un array con la información de propietarios que corresponde a los parámetros suministrados.
### Solicitud
```
Method: GET
https://factudesk.api.induxsoft.net/{p_rfc|p_nic}/propietarios/?ids=p_ids&uid=p_uid&pwd=p_wd&filtro=p_filtro&limit=p_limit
```
#### Parámetros
* ```p_filtro```. Texto de filtro para los resultados
* ```p_limit```. Cantidad máxima de filas a devolver, si se omite se asumen 500, el máximo admitido es 2000
### Respuesta
```
{
"success":true,
"data":[
{
"rfc": "RFC del propietario",
"numlicencia": "Número de licencia",
"nombre": "Nombre del propietario",
"registro_pais": "Registro fiscal del país",
"residencia_fiscal": "Reseidencia fiscal",
"pais": "Código del país",
"codigo_postal": "Código postal",
"estado": "Código del estado",
"municipio": "Código del municipio",
"localidad": "Localidad",
"colonia": "Colonia",
"calle": "Calle",
"num_exterior": "Número exterior",
"num_interior": "Número interior",
"referencia": "Referencia",
"id": "ID único para el registro"
},
...
]
}
```
## Consultar un propietario
Obtiene la información del propietario que correspondiente.
### Solicitud
```
Method: GET
https://factudesk.api.induxsoft.net/{p_rfc|p_nic}/propietarios/{p_codigo}/?ids=p_ids&uid=p_uid&pwd=p_wd
```
* ```p_codigo``` ID de un propietario
```
Respuesta
{
"success":true,
"data":{
"rfc": "RFC del propietario",
"numlicencia": "Número de licencia",
"nombre": "Nombre del propietario",
"registro_pais": "Registro fiscal del país",
"residencia_fiscal": "Residencia fiscal",
"pais": "Código del país",
"codigo_postal": "Código postal",
"estado": "Código del estado",
"municipio": "Código del municipio",
"localidad": "Localidad",
"colonia": "Colonia",
"calle": "Calle",
"num_exterior": "Número exterior",
"num_interior": "Número interior",
"referencia": "Referencia",
"id": "ID único para el registro"
}
}
```
## Agregar un propietario
Agrega un propietario a la base de datos del emisor
### Solicitud
```
Method: POST
https://factudesk.api.induxsoft.net/{p_rfc|p_nic}/propietarios/?ids=p_ids&uid=p_uid&pwd=p_wd
Payload
{
"rfc": "RFC del propietario",
"numlicencia": "Número de licencia",
"nombre": "Nombre del propietario",
"registropais": "Registro fiscal del país",
"residenciafiscal": "Residencia fiscal",
"pais": "Código del país",
"cp": "Código postal",
"estado": "Código del estado",
"municipio": "Código del municipio",
"localidad": "Localidad",
"colonia": "Colonia",
"calle": "Calle",
"numexterior": "Número exterior",
"numinterior": "Número interior",
"referencia": "Referencia",
"id_figura": "ID único para el registro, si no se establece el servicio genera el id_figura conforme el código del país y el RFC (MEXOPER6010034T6)"
}
```
### Respuesta
```
{
"success":true,
"data":{
"rfc": "RFC del propietario",
"numlicencia": "Número de licencia",
"nombre": "Nombre del propietario",
"registro_pais": "Registro fiscal del país",
"residencia_fiscal": "Residencia fiscal",
"pais": "Código del país",
"codigo_postal": "Código postal",
"estado": "Código del estado",
"municipio": "Código del municipio",
"localidad": "Localidad",
"colonia": "Colonia",
"calle": "Calle",
"num_exterior": "Número exterior",
"num_interior": "Número interior",
"referencia": "Referencia",
"id": "ID único para el registro"
}
}
```
## Modificar un propietario
Actualiza información de un propietario en la base de datos del emisor, solo los datos que se suministran.
### Solicitud
```
Method: PATCH
https://factudesk.api.induxsoft.net/{p_rfc|p_nic}/propietarios/{p_codigo}/?ids=p_ids&uid=p_uid&pwd=p_wd
{
"calle": "Calle",
"num_exterior": "Número exterior",
"num_interior": "Número interior",
}
```
* ```p_codigo``` ID de un propietario
### Respuesta
```
{
"success":true,
"data":{
"rfc": "RFC del propietario",
"numlicencia": "Número de licencia",
"nombre": "Nombre del propietario",
"registro_pais": "Registro fiscal del país",
"residencia_fiscal": "Residencia fiscal",
"pais": "Código del país",
"codigo_postal": "Código postal",
"estado": "Código del estado",
"municipio": "Código del municipio",
"localidad": "Localidad",
"colonia": "Colonia",
"calle": "Calle",
"num_exterior": "Número exterior",
"num_interior": "Número interior",
"referencia": "Referencia",
"id": "ID único para el registro"
}
}
```
## Eliminar un propietario
Elimina un propietario en la base de datos del emisor
### Solicitud
```
Method: DELETE
https://factudesk.api.induxsoft.net/{p_rfc|p_nic}/propietarios/{p_codigo}?ids=p_ids&uid=p_uid&pwd=p_wd
```
* ```p_codigo``` ID de un propietario
### Respuesta
```
{
"success":true,
"data":null
}
```