---
title: "POST /invoices"
method: POST
path: "/invoices"
---

# POST /invoices

`POST /invoices`

## Request body

- object
  - `customer` object, required — Objeto cliente
    - `object` string — Nombre de objeto
    - `external_id` string, required — Id único de cliente en los sistemas de la empresa
    - `name` string, required — Nombre completo del cliente
    - `phone` string, required — Teléfono de cliente en formato E.164
    - `email` string, required — Correo electrónico de cliente
    - `document_type` 'DNI' | 'RUC' | 'CEX' | 'OTHER', required — Tipo de documento DNI, RUC, CEX, OTHER. Si usa prefijo "solo" usar OTHER
    - `document_id` string, required — Número de documento del cliente. No incluir caracteres especiales (-, /, &, $, #, entre otros) ni espacios en blanco
  - `request_datetime` string, date-time, required — Fecha de solicitud del sistema de la empresa (ISO-8601: yyyy-MM-ddThh:mm:ss). Timezone en GMT
  - `currency` string, required — Moneda de la orden de pago (ISO-4217 - 3 dígitos)
  - `amount` number, double, required — Monto total de la orden de pago. Usar 2 decimales
  - `invoice_id` string, required — Número único de la deuda en los sistemas de la empresa (External ID)
  - `due_datetime` string, date-time — Fecha de vencimiento (ISO-8601: yyyy-MM-ddThh:mm:ss). Usado para aplicación de moras. Timezone en GMT. De no considerar este campo, el sistema por default considerará 15 días mas al request_datetime
  - `expiration_datetime` string, date-time — Fecha de expiración (ISO-8601: yyyy-MM-ddThh:mm:ss). Timezone en GMT
  - `metadata` string — Detalles adicionales a la orden de pago (formato JSON). Para valores personalizados consultar con su ejecutivo de cuentas. Ejemplo: {"order_id": "Referencia Deuda", "order_name": "Orden", "order_description": "Desc Orden"}

## Response `201`

Created

- object
  - `amount` string
  - `created` string
  - `currency` string
  - `customer` object
    - `document_id` string
    - `document_type` string
    - `email` string
    - `external_id` string
    - `name` string
    - `phone` string
  - `due_datetime` string
  - `expiration_datetime` string
  - `fees` integer
  - `gateway_url` string
  - `id` string
  - `invoice_id` string
  - `ktin` string
  - `late_fee` string
  - `livemode` string
  - `metadata` object
    - `order_description` string
    - `order_id` string
    - `order_name` string
  - `object` string
  - `psp_tin` string
  - `status` string
  - `sub_total` string
  - `token` string

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/kashio/apis/api-pasarela-10.md) · [All operations](https://skmtc.net/kashio/apis/api-pasarela-10/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kashio/api-pasarela-10/revisions/de854e8763a9/schema)