# Administración del catálogo de conceptos

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 conceptos

Obtiene un array con la información de conceptos que corresponde a los parámetros suministrados.

### Solicitud
```
Method: GET 
https://factudesk.api.induxsoft.net/{p_rfc|p_nic}/conceptos/?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":[
        {
            "sys_pk": Clave primaria interna,
            "sys_guid":"GUID de la fila",
            ... otros campos de sistema...,
            "codigo": "código único",
			"descripcion": "Descripción del concepto",
			"iva": porcentaje de iva,
			"ieps":porcentaje de ieps,
			"notas": "Nota",
			"precio": Precio unitario,
			"unidad": "Unidad",
			"ieps_despues_iva": true/false,
			"claveproductosat": "Clave del producto SAT",
			"claveunidadsat": "Clave unidad SAT",
			"aplicaretencion": true/false,
			"ivaretencion": IVA retenido,
			"iepsretencion": IEPS retenido,
			"exentoiva": true/false,
			"ieps_cuota": true/false,
			"objetoimp": "Objeto de Impuesto"
            
        },
        ...
    ]
}
```

## Consultar un concepto

Obtiene la información del concepto que correspondiente.

### Solicitud

```
Method: GET 
https://factudesk.api.induxsoft.net/{p_rfc|p_nic}/conceptos/{p_codigo}/?ids=p_ids&uid=p_uid&pwd=p_wd
```
```
Respuesta
{
    "success":true,
    "data":{
			"sys_pk": Clave primaria interna,
			"sys_guid": "GUID de la fila",
			"sys_dtcreated": "Fecha de creación",
			"sys_timestamp": "Fecha",
			"sys_recver": 0,
			"sys_deleted": true/false,
			"sys_lock": 0,
			"codigo": "código único",
			"descripcion": "Descripción del concepto",
			"iva": porcentaje de iva,
			"ieps":porcentaje de ieps,
			"notas": "Nota",
			"precio": Precio unitario,
			"unidad": "Unidad",
			"ieps_despues_iva": true/false,
			"claveproductosat": "Clave del producto SAT",
			"claveunidadsat": "Clave unidad SAT",
			"aplicaretencion": true/false,
			"ivaretencion": IVA retenido,
			"iepsretencion": IEPS retenido,
			"exentoiva": true/false,
			"ieps_cuota": true/false,
			"objetoimp": "Objeto de Impuesto"
	}
}
```

## Agregar un concepto
Agrega un concepto a la base de datos del emisor

### Solicitud
```

Method: POST
https://factudesk.api.induxsoft.net/{p_rfc|p_nic}/conceptos/?ids=p_ids&uid=p_uid&pwd=p_wd

Payload
{
     "codigo": "código único",
	"descripcion": "Descripción del concepto",
	"iva": porcentaje de iva,
	"ieps":porcentaje de ieps,
	"notas": "Nota",
	"precio": Precio unitario,
	"unidad": "Unidad",
	"ieps_despues_iva": true/false,
	"claveproductosat": "Clave del producto SAT",
	"claveunidadsat": "Clave unidad SAT",
	"aplicaretencion": true/false,
	"ivaretencion": IVA retenido,
	"iepsretencion": IEPS retenido,
	"exentoiva": true/false,
	"ieps_cuota": true/false,
	"objetoimp": "Objeto de Impuesto"
}
```
### Respuesta

```
{
    "success":true,
    "data":{
			"sys_pk": Clave primaria interna,
			"sys_guid": "GUID de la fila",
			"sys_dtcreated": "Fecha de creación",
			"sys_timestamp": "Fecha",
			"sys_recver": 0,
			"sys_deleted": true/false,
			"sys_lock": 0,
			"codigo": "código único",
			"descripcion": "Descripción del concepto",
			"iva": porcentaje de iva,
			"ieps":porcentaje de ieps,
			"notas": "Nota",
			"precio": Precio unitario,
			"unidad": "Unidad",
			"ieps_despues_iva": true/false,
			"claveproductosat": "Clave del producto SAT",
			"claveunidadsat": "Clave unidad SAT",
			"aplicaretencion": true/false,
			"ivaretencion": IVA retenido,
			"iepsretencion": IEPS retenido,
			"exentoiva": true/false,
			"ieps_cuota": true/false,
			"objetoimp": "Objeto de Impuesto"
	}
}
```

## Modificar un concepto

Actualiza información de un concepto 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}/conceptos/{p_codigo}/?ids=p_ids&uid=p_uid&pwd=p_wd

{
  "descripcion":"Descripción",
  "notas":"Notas",
  "iva":porcentaje de iva
}
```

* ```p_codigo``` Código de un concepto

### Respuesta

```
{
    "success":true,
    "data":{
			"sys_pk": Clave primaria interna,
			"sys_guid": "GUID de la fila",
			"sys_dtcreated": "Fecha de creación",
			"sys_timestamp": "Fecha",
			"sys_recver": 0,
			"sys_deleted": true/false,
			"sys_lock": 0,
			"codigo": "código único",
			"descripcion": "Descripción del concepto",
			"iva": porcentaje de iva,
			"ieps":porcentaje de ieps,
			"notas": "Nota",
			"precio": Precio unitario,
			"unidad": "Unidad",
			"ieps_despues_iva": true/false,
			"claveproductosat": "Clave del producto SAT",
			"claveunidadsat": "Clave unidad SAT",
			"aplicaretencion": true/false,
			"ivaretencion": IVA retenido,
			"iepsretencion": IEPS retenido,
			"exentoiva": true/false,
			"ieps_cuota": true/false,
			"objetoimp": "Objeto de Impuesto"
	}
}
```



## Eliminar un concepto

Elimina un concepto en la base de datos del emisor


### Solicitud
```
Method: DELETE
https://factudesk.api.induxsoft.net/{p_rfc|p_nic}/conceptos/{p_codigo}?ids=p_ids&uid=p_uid&pwd=p_wd

```

* ```p_codigo``` Código de un concepto

### Respuesta
```
{
    "success":true,
    "data":null
}
```