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

# POST /invoices

`POST /invoices`

## Request

- Base URL: `https://cert-api.kashio.net/v1/payments`
- URL: `https://cert-api.kashio.net/v1/payments/invoices`
- Auth: HTTP basic

## 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.dev/kashio/apis/api-conexionunica-10.md) - [All operations](https://skmtc.dev/kashio/apis/api-conexionunica-10/llms.txt) - [OpenAPI document](https://skmtc.dev/kashio/apis/api-conexionunica-10/revisions/bf272fff64f6?raw)