Los conceptos son los productos o servicio que un usuario puede proveer.

Los conceptos en Factura Gorila sirven como plantillas para llenar los detalles de una Factura. Al crear una factura el usuario selecciona conceptos para agregar a su factura, y el usuario debe tener la libertad de cambiar la descripción y precio para la factura que esta haciendo.

 

Obtener la lista de conceptos

Listado de conceptos

Para obtener los conceptos se accede por GET a la siguiente URL

https://app.facturagorila.com/v1/api/conceptos/

Este punto acepta los siguientes parámetros por query

  • p: es el número de página deseado empezando por 0 (cero)
  • epp: el número de elementos por página

Por ejemplo:

https://app.facturagorila.com/v1/api/conceptos/?p=2

Obtiene como resultados la tercera (a partir de cero) página de resultados. Los resultados están envueltos en un objeto Consulta.

Ejemplo respuesta (JSON):

{
   "TotalResultados":43,
   "CantidadPorPagina":10,
   "TotalDePaginas":5,
   "PaginaActual":0,
   "TipoDatoResultado":"Concepto",
   "Resultados":[
      {
         "ConceptoId":108,
         "Descripcion":"Libreta Pofesional 100 hojas",
         "Clave":"0002",
         "Precio":1.67,
         "Tipo":"Producto",
         "UnidadDeMedida":"Pieza",
         "UnidadDeMedidaId":1,
         "IDsImpuestosAplica":"3,3,7"
      },
      {
         "ConceptoId":110,
         "Descripcion":"Colegiatura",
         "Clave":"0003",
         "Precio":1.00,
         "Tipo":"Producto",
         "UnidadDeMedida":"Pieza",
         "UnidadDeMedidaId":1,
         "IDsImpuestosAplica":"3"
      },
      {
         "ConceptoId":129,
         "Descripcion":"Caja de lapices # 5",
         "Clave":"0007",
         "Precio":23.89,
         "Tipo":"Producto",
         "UnidadDeMedida":"Pieza",
         "UnidadDeMedidaId":1,
         "IDsImpuestosAplica":"3"
      },
      {
         "ConceptoId":107,
         "Descripcion":"Servicio de Mantenimiento de Computadora",
         "Clave":"0010",
         "Precio":1.56,
         "Tipo":"Producto",
         "UnidadDeMedida":"Pieza",
         "UnidadDeMedidaId":1,
         "IDsImpuestosAplica":"1,2,3,1,2,3"
      },
      {
         "ConceptoId":133,
         "Descripcion":"Artciulo Fronterizo",
         "Clave":"0033",
         "Precio":100.00,
         "Tipo":"Producto",
         "UnidadDeMedida":"Pieza",
         "UnidadDeMedidaId":1,
         "IDsImpuestosAplica":"7"
      },
      {
         "ConceptoId":130,
         "Descripcion":"Artciulo Tasa 0",
         "Clave":"5555",
         "Precio":100.00,
         "Tipo":"Producto",
         "UnidadDeMedida":"Pieza",
         "UnidadDeMedidaId":1,
         "IDsImpuestosAplica":"5"
      },
      {
         "ConceptoId":127,
         "Descripcion":"Concepto Prueba alta",
         "Clave":"78889",
         "Precio":45.67,
         "Tipo":"Producto",
         "UnidadDeMedida":"Pieza",
         "UnidadDeMedidaId":1,
         "IDsImpuestosAplica":""
      },
      {
         "ConceptoId":245,
         "Descripcion":"Mouse Bluetooth ",
         "Clave":"88888",
         "Precio":852.00,
         "Tipo":"Producto",
         "UnidadDeMedida":"Pieza",
         "UnidadDeMedidaId":1,
         "IDsImpuestosAplica":"3,5"
      },
      {
         "ConceptoId":218,
         "Descripcion":"Articulo 998",
         "Clave":"998",
         "Precio":200.00,
         "Tipo":"Producto",
         "UnidadDeMedida":"Pieza",
         "UnidadDeMedidaId":1,
         "IDsImpuestosAplica":"7"
      },
      {
         "ConceptoId":217,
         "Descripcion":"Articulo 999",
         "Clave":"9999",
         "Precio":100.00,
         "Tipo":"Producto",
         "UnidadDeMedida":"Pieza",
         "UnidadDeMedidaId":1,
         "IDsImpuestosAplica":"3,1,2,5,6"
      }
   ]
}

 

Obtener un solo Concepto

Conociendo el id de un concepto es posible consultarlo en la siguiente url por método GET

https://app.facturagorila.com/v1/api/conceptos/{id}

Ejemplo respuesta (JSON):

{
   "ConceptoId":108,
   "Descripcion":"Libreta Pofesional 100 hojas",
   "Clave":"0002",
   "Precio":1.67,
   "Tipo":"Producto",
   "UnidadDeMedida":"Pieza",
   "UnidadDeMedidaId":1,
   "IDsImpuestosAplica":"3,7"
}

 

Insertar un Concepto

Petición

Para crear un concepto se utiliza la siguiente url en método POST

https://app.facturagorila.com/v1/api/conceptos/

Lo siguientes parámetros son obligatorios:

  • Descripcion
  • Clave
  • Tipo
  • UnidadDeMedida
  • Precio
  • IDsImpuestosAplica

Ejemplo (JSON):

{
   "Tipo":"Producto",
   "IDsImpuestosAplica":"5,3",
   "Descripcion":"Mouse touch",
   "Clave":"719927293",
   "UnidadDeMedidaId":1,
   "Precio":2184.000000
}

 

Respuesta

Se retorna el objeto recién insertado. Además se incluye en el HTTP header Location una url al elemento recién insertado.

Ejemplo (JSON):

{
   "ConceptoId":246
   "Tipo":"Producto",
   "IDsImpuestosAplica":"5,3",
   "Descripcion":"Mouse touch",
   "Clave":"719927293",
   "UnidadDeMedidaId":1,
   "Precio":2184.000000
}

 

 

Actualizar un Concepto

Petición

Para actualizar un concepto se accede a la siguiente url

https://app.facturagorila.com/v1/api/conceptos/{id}

Respuesta

Se obtiene un código HTTP 200 en caso de éxito, o un 400 (Bad request) en caso de error.

 

Borrar un Concepto

Petición

Para borrar un concepto se accede a la siguiente url en método DELETE

https://app.facturagorila.com/v1/api/conceptos/{id}

Respuesta

Se regresa con un código de estado 200