Códigos tributarios

Hace referencia a los códigos del Tipo Documento Tributario Electrónico, además de otras referencias válidas ante SUNAT.

Estructura JSON

Al realizar una petición HTTP, el servicio retornara un JSON con la siguiente estructura:

{
  "href": "https://api.bsale.com.pe/v1/cpe_codes/45.json",
  "id": 45,
  "name": "BOLETA DE VENTA ",
  "code": "99",
  "state": 0
}
  • href, url del cliente (String).
  • id, identificador único del código tributario (Integer).
  • name, nombre del código tributario (String).
  • code, código tributario (String).
  • state, estado del código tributario indica si esta activo(0) o inactivo (1) (Boolean).

GET lista de códigos tributarios

  • GET /v1/cpe_codes.json retornara todas los codigos tributarios.

####Parametros

  • limit, limita la cantidad de items de una respuesta JSON, por defecto el limit es 25, el máximo permitido es 50.
  • offset, permite paginar los items de una respuesta JSON, por defecto el offset es 0.
  • fields, solo devolver atributos específicos de un recurso
  • expand, permite expandir instancias y colecciones.
  • name, Permite filtrar por nombre del código tributario.
  • code, filtra por código tributario.
  • state, boolean (0 o 1) indica si las monedas están activas(0) inactivas(1).

####Ejemplos

  • GET /v1/cpe_codes.json?limit=10&offset=0
  • GET /v1/cpe_codes.json?fields=[name,code,state]

####Respuesta

{
  "href": "https://api.bsale.com.pe/v1/cpe_codes.json",
  "count": 73,
  "limit": 25,
  "offset": 0,
  "items": [
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/28.json",
      "id": 28,
      "name": "AWB (Air Will Bill)",
      "code": "809",
      "state": 1
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/27.json",
      "id": 27,
      "name": "B/L (Conocimiento de embarque)",
      "code": "808",
      "state": 1
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/35.json",
      "id": 35,
      "name": "Boleta",
      "code": "35",
      "state": 1
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/45.json",
      "id": 45,
      "name": "BOLETA DE VENTA ",
      "code": "99",
      "state": 0
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/64.json",
      "id": 64,
      "name": "Boleta de Venta - emitida por anticipos",
      "code": "03",
      "state": 0
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/10.json",
      "id": 10,
      "name": "Boleta Electrónica",
      "code": "39",
      "state": 1
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/1.json",
      "id": 1,
      "name": "Boleta Exenta",
      "code": "38",
      "state": 1
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/11.json",
      "id": 11,
      "name": "Boleta Exenta Electrónica",
      "code": "41",
      "state": 1
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/52.json",
      "id": 52,
      "name": "BOLETO DE VIAJE",
      "code": "99",
      "state": 0
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/30.json",
      "id": 30,
      "name": "Carta de Porte",
      "code": "811",
      "state": 1
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/33.json",
      "id": 33,
      "name": "Certificado de Depósito Bolsa Prod. Chile",
      "code": "814",
      "state": 1
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/66.json",
      "id": 66,
      "name": "Código SCOP",
      "code": "05",
      "state": 0
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/58.json",
      "id": 58,
      "name": "COMPROBANTE DE PAGO SEAE",
      "code": "99",
      "state": 0
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/56.json",
      "id": 56,
      "name": "COMPROBANTE DE PERCEPCION",
      "code": "99",
      "state": 0
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/57.json",
      "id": 57,
      "name": "COMPROBANTE DE PERCEPCION - VENTA INTERNA",
      "code": "99",
      "state": 0
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/54.json",
      "id": 54,
      "name": "COMPROBANTE DE RETENCION",
      "code": "99",
      "state": 0
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/22.json",
      "id": 22,
      "name": "Contrato",
      "code": "803",
      "state": 1
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/38.json",
      "id": 38,
      "name": "Declaración de Ingreso (DIN)",
      "code": "914",
      "state": 1
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/50.json",
      "id": 50,
      "name": "DOCUMENTO BAJO EL CONTROL DE LA SUPERINTENDENCIA DE BANCA Y SEGUROS",
      "code": "99",
      "state": 0
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/53.json",
      "id": 53,
      "name": "DOCUMENTOS EMITIDOS POR LAS AFP",
      "code": "99",
      "state": 0
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/26.json",
      "id": 26,
      "name": "DUS",
      "code": "807",
      "state": 1
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/44.json",
      "id": 44,
      "name": "FACTURA",
      "code": "99",
      "state": 0
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/36.json",
      "id": 36,
      "name": "Factura",
      "code": "30",
      "state": 1
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/62.json",
      "id": 62,
      "name": "Factura - emitida para corregir error en el RUC",
      "code": "01",
      "state": 0
    },
    {
      "href": "https://api.bsale.com.pe/v1/cpe_codes/63.json",
      "id": 63,
      "name": "Factura - emitida por anticipos",
      "code": "02",
      "state": 0
    }
  ],
  "next": "https://api.bsale.com.pe/v1/cpe_codes.json?limit=25\u0026offset=25"
}

GET único código tributario

  • GET /v1/cte_codes/45.json

####Respuesta

{
  "href": "https://api.bsale.com.pe/v1/cpe_codes/45.json",
  "id": 45,
  "name": "BOLETA DE VENTA ",
  "code": "99",
  "state": 0
}