Quickstart
About us
API Endpoints
- 🔑 Authentication
- 🏢 Accounts
- 📝 Documents
- 📩 Inbox
- 📜 Digital certificate
Examples
- Chile
- Colombia
- Mexico
- Perú
- United States
Create a new document
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Short description to be included in the invoice as line title. Max 100 chars.
Quantity (can have up to 6 decimals, separate with a dot, not with a comma).
Total amount for this line, including taxes and modifiers.
Unit that this line is measured in.
Unit price (can have up to 6 decimals, separate with a dot, not with a comma). If using the 'gross_values' option, it must be the value including VAT.
Allows adding an additional long description to the detail description for the document.
Amount to discount or surcharge. If it is a discount, use a negative value. If this is used, do not use discount_or_surcharge_percentage.
Percentage to discount or surcharge. If it is a discount, use a negative value. If this is used, do not use discount_or_surcharge_amount.
Total taxes for this line.
DA = Global discount on taxable DE = Global discount on exempt RA = Global surcharge on taxable RE = Global surcharge on exempt
$ = Value will be applied as an amount % = Value will be applied as a percentage of the amount
Value of the discount or surcharge.
Document type ID according to document type table. Chile : 2 = Factura electrónica 32 = Factura exenta electrónica 37 = Boleta electrónica 41 = Boleta exenta electrónica 54 = Guía de despacho electrónica 17 = Nota de débito electrónica 16 = Nota de crédito electrónica 46 = Factura exportación electrónica 47 = Nota de débito de exportación electrónica 48 = Nota de crédito de exportación electrónica
Document issue date Format: YYYY-MM-DD
Payment dates separated by commas 0 = cash 30 = 30 days 0,30 = 50% cash, 50% in 30 days 0,30,60 = 33% cash, 33% in 30 days, 34% in 60 days.
Required for invoices, credit notes, and debit notes. Optional for other documents. Receiver activity of the document receiver. Named receipts should NOT include this field.
Required for invoices, credit notes, debit notes, named receipts, and exempt named receipts. Optional for other documents. Address of the document receiver.
Required for invoices, credit notes, debit notes, named receipts, and exempt named receipts. Optional for other documents. City of the document receiver.
Required for invoices, credit notes, debit notes, named receipts, and exempt named receipts. Optional for other documents. District of the document receiver.
Required for invoices, credit notes, debit notes, named receipts, and exempt named receipts. Optional for other documents. Phone of the document receiver.
This field should only be completed for companies that use branches. To issue from the head office, this field should NOT be entered. The code entered must correspond to the 'internal code' entered in ROW.
Only for export documents. Valid values according to the table in annexes.
0 = do not include remark in XML or PDF 1 = include remark in XML and PDF 2 = include remark in PDF and do NOT include in XML 3 = include remark in XML and do NOT include in PDF In all cases, regardless of its display, the remark will be saved in ROW and will be visible in the document details on facto.cl. If this option is not entered, the default value is considered to be 1, which will display the remark in the XML and PDF.
Allows defining the folio to be used for issuing the document. By default, this field should NOT be used, so the folio is automatically assigned by the sequence.
Only when currency_id is defined and its value is not Chilean peso.
Enter a gross weight.
Required ONLY for dispatch guides. 1 = Operation constitutes sale 2 = Sales to be made 3 = Consignments 4 = Free delivery 5 = Internal transfers 6 = Other non-sale transfers 7 = Return guide 8 = Transfer for export (non-sale) 9 = Sale for export
Enter a observations.
Enter a port disembarkation.
Enter a port embarkation.
Refers to the recipient's country. If not provided, the default is the same country as the issuer. It is mainly used for export documents.
Email for document sending.
Required for invoices, credit notes, debit notes, named receipts, and exempt named receipts. Optional for other documents. Legal name of the document receiver.
Required for invoices, credit notes, debit notes, named receipts, and exempt named receipts, and optional for other documents. RUT without dots, with a hyphen Format: NNNNNNNN-X
Only for export documents: optional. Valid values: 1 = CIF 2 = CFR 3 = EXW 4 = FAS 5 = FOB 6 = S/CL 9 = DDP 10 = FCA 11 = CPT 12 = CIP 17 = DAT 18 = DAP 8 = Other
Only for export documents: optional. Valid values: 1 = Sale agreed 2 = Under condition 3 = Free consignment 4 = Consignment with minimum sale 9 = No payment
User ID (ROW) that will be assigned as the seller associated with the document.
It is optional to complete for export documents. Valid values: 1 = Invoice for periodic household services. 2 = Invoice for other periodic services. 3 = Service Invoice 4 = Hospitality Services 5 = International Land Transport Service
Enter a shipping address.
Required ONLY for dispatch guides that are not internal transfers. 1 = Dispatch on behalf of the recipient 2 = Dispatch on behalf of the issuer to recipient's facilities 3 = Dispatch on behalf of the issuer to other facilities
You can enter an email, which will replace the one registered in the Row account data and will be reflected in the automatic email sent to the document recipient.
You can enter a website URL, which will replace the one registered in the ROW account data and will be reflected in the automatic email sent to the recipient. It must start with http:// or https://.
This field is only valid for electronic receipts (document_type_id = 39, Chile) and allows the values to be entered as gross amounts (including VAT) for the line items, with the total being directly calculated as the multiplication of the item prices by the quantities. The total calculated in this way will be slightly different from the one obtained by rounding the net amounts and calculating VAT on the net total. The amounts will be adjusted and saved as net values in Row, but respecting the rounding applied to the gross amounts.
You can input values as “net” or “gross”. Rounding on gross values will calculate the total value for each line including VAT, and then adjust the document's VAT totals to match the final amount. Rounding on net values will calculate the multiplications of net values line by line, and then apply the VAT to the total net amount to get the VAT and the total.
It corresponds to the ID of the print template for the document. If not provided, the default template will be used. If provided and the template is not found, the default template will be used.
Reference description.
1 = cancel 2 = correct text 3 = correct quantity 4 = set 5 = reference to other non-tax documents 6 = reference to dispatch guide 7 = global reference to a type of document (allows reducing the amount for all documents of this type for this particular client).
Number of the referenced document. In the case of a global reference, it must be 0.
Chile: 33 = Factura electrónica 34 = Factura exenta electrónica 39 = Boleta electrónica 41 = Boleta exenta electrónica Otros documentos que no son documentos tributarios electrónicos: (debe usarse código referencia = 5) 801 = Orden de compra 802 = Nota de pedido 803 = Contrato 804 = Resolución 805 = Proceso ChileCompra 806 = Ficha ChileCompra 807 = DUS 808 = B/L (Conocimiento de embarque) 809 = AWB (Air Will Bill) 810 = MIC/DTA 811 = Carta de Porte 812 = Resolución del SNA donde califica Servicios de Exportación 813 = Pasaporte 814 = Certificado de Depósito Bolsa Prod. Chile. 815 = Vale de Prenda Bolsa Prod.
It should only be entered when using a reference that is not an electronic tax document. (YYYY-MM-DD).
Required, except in the case of gross values. Total value of taxable items. It should NOT be entered if using the 'gross_values' option.
Final value.
Sum of other taxes, can be negative if there are withholding taxes. NOT supported in the case of 'gross_values'.
65% credit for construction companies. Article 21 of Decree Law No. 910/75. This is the only code that operates in the opposite manner to the rest, as it is subtracted from the general VAT. It corresponds to VAT * 0.65. NOT supported in the case of 'gross_values' (Chile).
Response
Quantity of this product or service included in this line
Total of the line, including net price and taxes
Price per unit
Short description to be included in the invoice as line title. Max 100 chars
Long description to be included in the invoice as line title. Max 100 chars
Positive or negative percentage to be applied before calculating the line total. Example: -6.5 for a 6.5% discount
Total of all taxes included for this detail
Unit that this line is measured in
Identify if it has value added tax.
Document ID.
Currency ID according to currency table
Document type ID according to document type table.
Document issue date.
Represents the activity or business operation of the document issuer
Issuer address
Identifier for the city of the document issuer
Identifier for the district of the document issuer
Issuer phone number
The activity of the document receiver
Required address
The city of the document receiver
The location code of the document receiver
The phone of the document receiver
Account ID.
Document number.
0 = draft 1= document_issued 2=document sent to counterparty 3 = document accepted by counterparty
Type of document at the tax bureau.
Identifier for the country of the document issuer
Issuer legal name
Tax ID code according to tax id table. Required when the document requires the receiver to be specified.
Tax ID type according to tax id table. Required when the document requires the receiver to be specified.
Payment due dates separated by comma. Example: 0 = same day, 30 = 30 days 0,30 = 50% on issuance date, 50% 30 days later, 0,30,60 = 33% on issuance, 33% 30 days, 34% 60 days
0 = received, 1 = issued
Country ID according to ID table
Receiver legal name
The tax identification code of the document receiver
Tax ID type according to tax id table. Required when the document requires the receiver to be specified.
Tax period where the documents should be accounted
Tax period where the documents should be accounted
Read only. Null if not sent to tax bureau
Read only. Null if not sent to tax bureau
Document status at the tax bureau.
Waybills only. 1 = Despacho por cuenta del receptor 2 = Despacho por cuenta del emisor a instalaciones del receptor 3 = Despacho por cuenta del emisor a otras instalaciones
Waybills only. 1 = Operation constitutes a sale 2 = Ventas por efectuar 3 = Consignaciones 4 = Entrega gratuita 5 = Traslados internos 6 = Otros traslados no venta 7 = Guía de devolución 8 = Traslado para exportación (no venta) 9 = Venta para exportación