v1

latestOpenAPI 3.0.32026-07-24398641.3 MB

Facturas de venta

Crear factura de venta

Endpoint que permite crear una factura de venta desde cero.

post/invoices

Request body

datestring date required

Fecha de la factura. Formato yyyy-MM-dd.

dueDatestring date required

Fecha de vencimiento de la factura. Formato yyyy-MM-dd.

observationsstring

Observaciones de la factura (no visibles en el pdf o documento impreso). Longitud máxima permitida: 500.

anotationstring

Notas de la factura, visibles en el PDF o documento impreso. Longitud máxima permitida: 500.

termsConditionsstring

Términos y condiciones de la factura. Longitud máxima permitida: 500.

sellerobject

Objeto que indica el id del vendedor asociado a la factura. Se puede enviar directamente el id del vendedor en este atributo.

priceListobject

Objeto que indica el id de la lista de precios asociada a la factura. Se puede enviar directamente el id de la lista de precios en este atributo.

currencyobject

Objecto que incluye la información de la moneda y tasa de cambio asociada a la factura. Solo se debe incluir si la compañía tiene activa la funcionalidad de multimoneda y tiene configurada la moneda seleccionada. Debe incluir el código de la moneda (de tres letras según ISO) y la tasa de cambio.

warehouseobject

Objeto que indica el id de la bodega/almacén asociada a la factura. Se puede enviar directamente el id de la bodega/almacén en este atributo. Si no se envía este parámetro la factura queda asociada a la bodega/almacén Principal.

costCenterobject

Objeto que indica el id del centro de costo asociado. Se puede enviar directamente el id del centro de costo en este atributo o enviarlo como objeto.

commentsstring[]

Arreglo de strings con cada uno de los comentarios que se desean asociar. Los comentarios se pueden actualizar aun si la factura de venta no se puede editar.

statusstring

Estado de la factura, las opciones posibles son: open o draft. Si no se envía este atributo y no se envían pagos asociados la factura se crea en "draft". Si se envían pagos a la factura, la factura queda creada en "open".

Para Costa Rica versión 4.4, indica el método de pago de la factura. Las opciones posibles son: CASH, SINPE_MOVIL, CARD, CHECK, TRANSFER, COLLECTION_BY_THIRD, PLATFORM_DIGITAL, OTHER. Consulta el catálogo de parámetros correspondiente haciendo clic aquí. Si se desea emitir la factura, este atributo se vuelve obligatorio.

otherPaymentMethodstring

Campo obligatorio cuando paymentMethod es OTHER. Descripción del método de pago personalizado. Debe tener entre 3 y 100 caracteres.

Para Costa Rica versión 4.4, indica la condición de la venta. Consulta el catálogo de parámetros correspondiente haciendo clic aquí. Si se desea emitir la factura, este atributo se vuelve obligatorio.

otherSaleConditionstring

Campo obligatorio cuando saleCondition es OTHER. Descripción de la condición de venta personalizada. Debe tener entre 5 y 100 caracteres.

typestring

Indica el tipo de la factura de venta. Si no se envía, se asignará por defecto el código: NATIONAL.

economicActivityinteger

Para Costa Rica versión 4.4, indica el código de la actividad económica asociada a la factura. Si no se envía, se asignará por defecto el código de la actividad económica de la compañía.

Example request

{
  "date": "2019-02-12",
  "dueDate": "2019-02-12",
  "observations": "Estas son las observaciones de mi factura.",
  "seller": {
    "$ref": "#/paths/~1invoices~1%7Bid%7D/put/requestBody/content/application~1json/schema/oneOf/7/properties/seller/oneOf/1/example"
  },
  "priceList": {
    "$ref": "#/paths/~1invoices~1%7Bid%7D/put/requestBody/content/application~1json/schema/oneOf/7/properties/seller/oneOf/1/example"
  },
  "warehouse": {
    "$ref": "#/paths/~1invoices~1%7Bid%7D/put/requestBody/content/application~1json/schema/oneOf/7/properties/seller/oneOf/1/example"
  },
  "costCenter": {
    "$ref": "#/paths/~1invoices~1%7Bid%7D/put/requestBody/content/application~1json/schema/oneOf/7/properties/seller/oneOf/1/example"
  },
  "stamp": {
    "generateStamp": true
  }
}

Response

Retorna información de una factura