POST /v1/ecommerce/sales/:id/dte

POST

ecommerce

sales

{id}

dte

Emitir el DTE de una venta

curl --request POST \
  --url https://api.keebai.com/v1/ecommerce/sales/{id}/dte \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "due_date": "2026-12-10",
  "save_receiver": true
}
'

import requests

url = "https://api.keebai.com/v1/ecommerce/sales/{id}/dte"

payload = {
    "due_date": "2026-12-10",
    "save_receiver": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({due_date: '2026-12-10', save_receiver: true})
};

fetch('https://api.keebai.com/v1/ecommerce/sales/{id}/dte', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.keebai.com/v1/ecommerce/sales/{id}/dte",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'due_date' => '2026-12-10',
    'save_receiver' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.keebai.com/v1/ecommerce/sales/{id}/dte"

	payload := strings.NewReader("{\n  \"due_date\": \"2026-12-10\",\n  \"save_receiver\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.keebai.com/v1/ecommerce/sales/{id}/dte")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"due_date\": \"2026-12-10\",\n  \"save_receiver\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.keebai.com/v1/ecommerce/sales/{id}/dte")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"due_date\": \"2026-12-10\",\n  \"save_receiver\": true\n}"

response = http.request(request)
puts response.read_body

{
  "issued": [
    {
      "sale_id": "<string>",
      "document": "invoice",
      "type": 123,
      "folio": 123,
      "document_id": "<string>",
      "status": "<string>",
      "net": 123,
      "exempt": 123,
      "tax": 123,
      "total": 123,
      "due_date": "<string>"
    }
  ],
  "failed": [
    {
      "sale_id": "<string>",
      "reason": "<string>",
      "message": "<string>"
    }
  ]
}

Issues the DTE of a sale that already exists — for example one created without dte, or one whose DTE failed when it was created with POST /v1/ecommerce/sales.

Endpoint

POST https://api.keebai.com/v1/ecommerce/sales/{id}/dte

Required scope

ecommerce:invoicing:issue

The scope comes from your role. Minting a token with ecommerce:invoicing:issue requires the permission to issue DTE in your Keebai role, unless you are the company owner or a superuser. See scopes.

Headers

Header	Required	Value
`Authorization`	Yes	`Bearer kbai_pk_<token>`
`Content-Type`	Yes	`application/json`

Path parameters

Field	Type	Required	Description
`id`	`string`	Yes	`ObjectId` of the sale.

Body

Field	Type	Required	Description
`document`	`string`	Yes	`receipt` (boleta), `exempt_receipt` (boleta exenta), `invoice` (factura), or `exempt_invoice` (factura exenta).
`receiver`	`object`	Conditional	`rut`, `legal_name`, `activity`, `address`, `commune`, `email?`. Required for `invoice` and `exempt_invoice`. For a RUT the company invoiced before, `rut` alone is enough: the rest is filled in from the stored data, and any field you send overrides it.
`due_date`	`string`	No	`YYYY-MM-DD`. Due date of an invoice issued on credit, on a sale that is not fully paid. Defaults to today plus the company’s credit days. Ignored when the sale is paid.
`save_receiver`	`boolean`	No	Save the receiver for later documents.

Example request

curl -X POST https://api.keebai.com/v1/ecommerce/sales/65e4f5a6b7c8d9e0f1a2b3c4/dte \
  -H "Authorization: Bearer kbai_pk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "document": "invoice",
    "receiver": {
      "rut": "76123456-7",
      "legal_name": "Comercial Ejemplo SpA",
      "activity": "Venta al por menor",
      "address": "Av. Libertador 1234",
      "commune": "Santiago",
      "email": "facturas@ejemplo.cl"
    },
    "save_receiver": true
  }'

const response = await fetch(
  `https://api.keebai.com/v1/ecommerce/sales/${saleId}/dte`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.KEEBAI_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ document: "receipt" }),
  },
);
const { issued, failed } = await response.json();

import os, requests

resp = requests.post(
    f"https://api.keebai.com/v1/ecommerce/sales/{sale_id}/dte",
    headers={"Authorization": f"Bearer {os.environ['KEEBAI_API_TOKEN']}"},
    json={"document": "receipt"},
    timeout=30,
)
resp.raise_for_status()
result = resp.json()

Response

200 OK

The call answers with what was issued and what failed. A DTE that cannot be issued comes back in failed with its reason, not as an HTTP error.

{
  "issued": [
    {
      "sale_id": "65e4f5a6b7c8d9e0f1a2b3c4",
      "document": "invoice",
      "type": 33,
      "folio": 8211,
      "document_id": "6653e4f5a6b7c8d9e0f1a2b4",
      "status": "uploaded"
    }
  ],
  "failed": []
}

Failed

{
  "issued": [],
  "failed": [
    {
      "sale_id": "65e4f5a6b7c8d9e0f1a2b3c4",
      "reason": "unpaid"
    }
  ]
}

Field	Type	Description
`issued[]`	`object[]`	Documents issued: `sale_id`, `document`, `type` (SII code), `folio`, `document_id`, `status`.
`failed[]`	`object[]`	Documents not issued: `sale_id`, `reason` (the error code), `message?`.

Failure reasons

`reason`	Meaning
`already_issued`	The sale already has its DTE.
`unpaid`	A `receipt` or `exempt_receipt` on a sale that is not fully paid. Receipts always need full payment.
`credit_not_enabled`	An `invoice` or `exempt_invoice` on a sale that is not fully paid, and the company has not enabled credit invoices.
`due_date_invalid`	`due_date` is not a valid date or is earlier than the issue date.
`receiver_required`	An `invoice` or `exempt_invoice` needs `receiver`.
`not_completed`	The sale is not completed.
`deleted`	The sale was deleted.
`exempt_type_required`	The sale has no taxed lines, so it needs an exempt document (`exempt_receipt` or `exempt_invoice`).
`taxed_lines`	The sale has taxed lines, so an exempt document does not apply.
`no_lines`	The sale has no lines to invoice.
`too_many_items`	The sale has more lines than the document allows.
`amount_invalid`	The sale’s amount cannot be invoiced.

400 Bad Request

The body does not match the schema, DUE_DATE_INVALID (due_date is not YYYY-MM-DD or is before today), or dte_issuer_missing: the company has not registered its DTE issuer yet. That is configured in the portal.

401 Unauthorized

Missing, invalid, revoked, or expired token.

403 Forbidden

The token does not have the ecommerce:invoicing:issue scope.

404 Not Found

No sale with that id, or it belongs to a different company.

422 Unprocessable Entity

RECEIVER_DATA_REQUIRED — the invoice receiver is incomplete and the RUT has no stored data to fill it. missing lists the fields. Nothing is issued.

502 Bad Gateway

ECOMMERCE_UPSTREAM_ERROR — the ecommerce service could not answer.

Operational notes

Branch on failed, not only on the status. A request that did not issue anything can still succeed at the HTTP level.
already_issued makes retries safe. Calling again for a sale that already has its DTE does not issue a second one; it comes back in failed with that reason.
Check the documents first. GET /v1/ecommerce/invoicing/types tells you which document values the company can issue today and whether it allows credit invoices.
Invoices can go on credit. With credit invoices enabled in Sales › Settings, an invoice on a sale that is not fully paid is issued as a credit invoice with its due date. Record the payment later from the Keebai portal or with the MCP tool keebai_ecommerce_sale_payment_add.
Read the issued documents with GET /v1/ecommerce/sales/{id}/documents.

Authorizations

Authorization

string

header

required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Path Parameters

string

required

Body

application/json

document

enum<string>

required

invoice (factura), exempt_invoice (factura exenta), receipt (boleta), exempt_receipt (boleta exenta). La factura exige receiver; con un RUT ya facturado basta receiver.rut

Available options:

invoice,

exempt_invoice,

receipt,

exempt_receipt

due_date

string

Vencimiento (YYYY-MM-DD) de una factura emitida a crédito, sobre una venta que no está pagada completa. Sin él, hoy más los días configurados en la empresa. Se ignora si la venta está pagada

Example:

"2026-12-10"

receiver

object

Show child attributes

save_receiver

boolean

Guarda el receptor en el cliente para la próxima factura

Response

200 - application/json

issued

object[]

required

Show child attributes

failed

object[]

required

Show child attributes

Emitir el DTE de una venta

curl --request POST \
  --url https://api.keebai.com/v1/ecommerce/sales/{id}/dte \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "due_date": "2026-12-10",
  "save_receiver": true
}
'

import requests

url = "https://api.keebai.com/v1/ecommerce/sales/{id}/dte"

payload = {
    "due_date": "2026-12-10",
    "save_receiver": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({due_date: '2026-12-10', save_receiver: true})
};

fetch('https://api.keebai.com/v1/ecommerce/sales/{id}/dte', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.keebai.com/v1/ecommerce/sales/{id}/dte",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'due_date' => '2026-12-10',
    'save_receiver' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.keebai.com/v1/ecommerce/sales/{id}/dte"

	payload := strings.NewReader("{\n  \"due_date\": \"2026-12-10\",\n  \"save_receiver\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.keebai.com/v1/ecommerce/sales/{id}/dte")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"due_date\": \"2026-12-10\",\n  \"save_receiver\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.keebai.com/v1/ecommerce/sales/{id}/dte")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"due_date\": \"2026-12-10\",\n  \"save_receiver\": true\n}"

response = http.request(request)
puts response.read_body

{
  "issued": [
    {
      "sale_id": "<string>",
      "document": "invoice",
      "type": 123,
      "folio": 123,
      "document_id": "<string>",
      "status": "<string>",
      "net": 123,
      "exempt": 123,
      "tax": 123,
      "total": 123,
      "due_date": "<string>"
    }
  ],
  "failed": [
    {
      "sale_id": "<string>",
      "reason": "<string>",
      "message": "<string>"
    }
  ]
}

Get started

Products

Inventory

Carts

Sales

Electronic invoicing

POST /v1/ecommerce/sales/:id/dte

Endpoint

Required scope

Headers

Path parameters

Body

Example request

Response

200 OK

Failure reasons

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found

422 Unprocessable Entity

502 Bad Gateway

Operational notes

Authorizations

Path Parameters

Body

Response

​Endpoint

​Required scope

​Headers

​Path parameters

​Body

​Example request

​Response

​200 OK

​Failure reasons

​400 Bad Request

​401 Unauthorized

​403 Forbidden

​404 Not Found

​422 Unprocessable Entity

​502 Bad Gateway

​Operational notes

Authorizations

Path Parameters

Body

Response

Endpoint

Required scope

Headers

Path parameters

Body

Example request

Response

200 OK

Failure reasons

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found

422 Unprocessable Entity

502 Bad Gateway

Operational notes