Degradado Banner Interno

Documentación Express API Bsale

Emisión de Documentos Tributarios Electrónicos

¿Qué necesito para generar un documento por la API Bsale?

Documentación Completa

Ambiente para envíos
Access Token
Prueba localmente

Creación de boleta electrónica

POST /v1/documents.json

{
  "codeSii": 39,
  "officeId": "1",
  "emissionDate": 1462527931,
  "details": [
    {
      "netUnitValue": 10916,
      "quantity": 1,
      "comment": "el nombre del producto que voy a vender",
      "taxes": [
        {
          "code": 14,
          "percentage": 19
        }
      ]
    }
  ]
}

¡Pruébalo!

  • codeSii:Código tributario del documento
  • officeId:Id de la sucursal que emite el documento
  • emissionDate:Fecha de emisión (unix)
  • netUnitValue:Valor neto unitario
  • quantity:Cantidad
  • comment:Detalle que venderás
  • code:Código del impuesto
  • percentage:Porcentaje del impuesto
Documentación extendida

Creación de factura electrónica

POST /v1/documents.json

{
  "codeSii": 33,
  "officeId": 1,
  "emissionDate": 1462527931,
  "client": {
    "code": "1-9",
    "company": "DEMO API BSALE SA",
    "activity": "Giro Informática",
    "municipality": "Comuna",
    "city": "Puerto Varas",
    "address": "Dirección",
    "email": "api@bsale.cl"
  },
  "details": [
    {
      "netUnitValue": 21008,
      "quantity": 1,
      "taxes": [

        {
          "code": 14,
          "percentage": 19
        }
      ],
      "comment": "Nombre producto que voy a vender"
    }
  ],
  "payments": [
    {
      "paymentTypeId": 1,
      "amount": 25000,
      "recordDate": 1462527931
    }   
  ]
}

¡Pruébalo!

  • codeSii:Código tributario del documento
  • officeId:Id de la sucursal que emite el documento
  • emissionDate:Fecha de emisión (unix)
  • code:RUT de cliente
  • company:Razón social del cliente
  • activity:Giro de cliente
  • municipality:Comuna de cliente
  • city:Ciudad cliente
  • address:Dirección de cliente
  • email:Correo de cliente
  • netUnitValue:Valor neto unitario
  • quantity:Cantidad
  • comment:Detalle que venderás
  • code:Código del impuesto
  • percentage:Porcentaje del impuesto
  • paymentTypeId:Identificador del tipo de pago
  • amount:Monto del pago
  • recordDate:Fecha de pago (unix)
Documentación extendida

Creación de guía de despacho electrónica

POST /v1/shippings.json

{
  "codeSii": 52,
  "officeId": 1,
  "emissionDate": 1462527931,
  "shippingTypeId": 6,
  "municipality": "Puerto Varas",
  "city": "Puerto Varas",
  "address": "la quebrada 1005",
  "recipient": "Edison Packard",
  "details": [
    {
      "quantity": 500,
      "code": "1372685554",
      "netUnitValue": 12000
    }
  ],
  "client": {
    "code": "99098656-8",    
    "municipality": "Puerto Montt",
    "activity": "Arriendo de maquinaria pesada",
    "company": "Maquinarías Express",
    "city": "PUERTO MONTT",
    "email": "apidespachos@bsale.cl",
    "address": "Los Alamos #122"
  }
}

¡Pruébalo!

  • codeSii:Código tributario del documento
  • officeId:Id de la sucursal que emite el documento
  • emissionDate:Fecha de emisión (unix)
  • shippingTypeId:Identificador del tipo de despacho
  • municipality:Comuna de envío
  • city:Ciudad de envío
  • address:Dirección de envío
  • recipient:Contacto quien recibe envío
  • netUnitValue:Valor neto unitario
  • quantity:Cantidad
  • comment:Detalle que venderás
  • code:Rut de cliente
  • company:Razón social de cliente
  • activity:Giro de cliente
  • municipality:Comuna de cliente
  • city:Ciudad cliente
  • address:Dirección de cliente
  • email:Correo de cliente
Documentación extendida

Creación de devoluciones

POST /v1/returns.json

{
  "codeSii": 61,
  "officeId": 1,
  "expirationDate": 1565096212,
  "emissionDate": 1565096212,
  "referenceDocumentId": 1031,
  "motive": "Devolución de productos",
  "priceAdjustment": 0,
  "editTexts": 0,
  "type": 1,
  "client": {
    "code": "1-9",
    "city": "Puerto Varas",
    "municipality": "comuna",
    "activity": "giro",
    "address": "direccion"
  },
  "details": [
    {
      "documentDetailId": 1405,
      "quantity": 1,
      "unitValue": 0
    }
  ]
}

¡Pruébalo!

  • codeSii:Código tributario del documento
  • officeId:Id de la sucursal que emite el documento
  • emissionDate:Fecha de emisión (unix)
  • referenceDocumentId:Referencia del ID venta que se desea devolver/anular
  • motive:Motivo devolución
  • code:Rut de cliente
  • company:Razón social de cliente
  • activity:Giro de cliente
  • municipality:Comuna de cliente
  • city:Ciudad cliente
  • address:Dirección de cliente
  • UnitValue:Valor neto unitario que se devolverá
  • quantity:Cantidad
  • documentDetailId:ID detalle de la venta que se está referenciando
Documentación extendida