FACTURA GRAVADA
POST/api/documents
La Factura Electrónica es un comprobante de pago emitido a través del sistema de emisión electrónica desarrollado desde los sistemas del contribuyente, permitiendo la sustentación del costo-gasto para efectos del Impuesto a la Renta y la utilización del crédito fiscal del Impuesto General a las Ventas.
Ejemplo:
- Método: POST
- URL: https://demo.pro5.fastura.app/api/documents
- TOKEN: HOHYgwd4atPalTxqi2IIspythpLAU7eP239oByfjk9VuveiOpfUTm4Yg0Szt
Request
- application/json
- application/xml
- application/x-www-form-urlencoded
Body
required
- JSON A ENVIAR
Array [
]
serie_documentostringrequired
Example:
F001numero_documentostringrequired
Example:
#fecha_de_emisiondaterequired
Example:
2023-09-21hora_de_emisiontimerequired
Example:
10:11:11codigo_tipo_operacionstringrequired
Example:
0101codigo_tipo_documentostringrequired
Example:
01codigo_tipo_monedastringrequired
Example:
PENfecha_de_vencimientodaterequired
Example:
2023-09-21numero_orden_de_comprastring
Example:
0045467898datos_del_cliente_o_receptor
object
required
codigo_tipo_documento_identidadstring
Example:
6numero_documentostring
Example:
10414711225apellidos_y_nombres_o_razon_socialstring
Example:
EMPRESA XYZ S.A.codigo_paisstring
Example:
PEubigeostring
Example:
150101direccionstring
Example:
Av. 2 de Mayocorreo_electronicostring
Example:
demo@gmail.comtelefonostring
Example:
427-1148totales
object
required
total_exportacionfloat
Example:
0total_operaciones_gravadasfloat
Example:
100total_operaciones_inafectasfloat
Example:
0total_operaciones_exoneradasfloat
Example:
0total_operaciones_gratuitasfloat
Example:
0total_igvfloat
Example:
18total_impuestosfloat
Example:
18total_valorfloat
Example:
100total_ventafloat
Example:
118items
object[]
required
codigo_internostring
Example:
P0121descripcionstring
Example:
Inca Kola 250 mlcodigo_producto_sunatstring
Example:
51121703unidad_de_medidastring
Example:
NIUcantidadint32
Example:
2valor_unitariofloat
Example:
50codigo_tipo_preciostring
Example:
01precio_unitariofloat
Example:
59codigo_tipo_afectacion_igvstring
Example:
10total_base_igvfloat
Example:
100porcentaje_igvfloat
Example:
18total_igvfloat
Example:
18total_impuestosfloat
Example:
18total_valor_itemfloat
Example:
100total_itemfloat
Example:
118informacion_adicionalstring
Example:
Forma de pago:Efectivo|Caja: 1Body
required
- JSON A ENVIAR
Array [
]
serie_documentostringrequired
Example:
F001numero_documentostringrequired
Example:
#fecha_de_emisiondaterequired
Example:
2023-09-21hora_de_emisiontimerequired
Example:
10:11:11codigo_tipo_operacionstringrequired
Example:
0101codigo_tipo_documentostringrequired
Example:
01codigo_tipo_monedastringrequired
Example:
PENfecha_de_vencimientodaterequired
Example:
2023-09-21numero_orden_de_comprastring
Example:
0045467898datos_del_cliente_o_receptor
object
required
codigo_tipo_documento_identidadstring
Example:
6numero_documentostring
Example:
10414711225apellidos_y_nombres_o_razon_socialstring
Example:
EMPRESA XYZ S.A.codigo_paisstring
Example:
PEubigeostring
Example:
150101direccionstring
Example:
Av. 2 de Mayocorreo_electronicostring
Example:
demo@gmail.comtelefonostring
Example:
427-1148totales
object
required
total_exportacionfloat
Example:
0total_operaciones_gravadasfloat
Example:
100total_operaciones_inafectasfloat
Example:
0total_operaciones_exoneradasfloat
Example:
0total_operaciones_gratuitasfloat
Example:
0total_igvfloat
Example:
18total_impuestosfloat
Example:
18total_valorfloat
Example:
100total_ventafloat
Example:
118items
object[]
required
codigo_internostring
Example:
P0121descripcionstring
Example:
Inca Kola 250 mlcodigo_producto_sunatstring
Example:
51121703unidad_de_medidastring
Example:
NIUcantidadint32
Example:
2valor_unitariofloat
Example:
50codigo_tipo_preciostring
Example:
01precio_unitariofloat
Example:
59codigo_tipo_afectacion_igvstring
Example:
10total_base_igvfloat
Example:
100porcentaje_igvfloat
Example:
18total_igvfloat
Example:
18total_impuestosfloat
Example:
18total_valor_itemfloat
Example:
100total_itemfloat
Example:
118informacion_adicionalstring
Example:
Forma de pago:Efectivo|Caja: 1Body
required
- JSON A ENVIAR
Array [
]
serie_documentostringrequired
Example:
F001numero_documentostringrequired
Example:
#fecha_de_emisiondaterequired
Example:
2023-09-21hora_de_emisiontimerequired
Example:
10:11:11codigo_tipo_operacionstringrequired
Example:
0101codigo_tipo_documentostringrequired
Example:
01codigo_tipo_monedastringrequired
Example:
PENfecha_de_vencimientodaterequired
Example:
2023-09-21numero_orden_de_comprastring
Example:
0045467898datos_del_cliente_o_receptor
object
required
codigo_tipo_documento_identidadstring
Example:
6numero_documentostring
Example:
10414711225apellidos_y_nombres_o_razon_socialstring
Example:
EMPRESA XYZ S.A.codigo_paisstring
Example:
PEubigeostring
Example:
150101direccionstring
Example:
Av. 2 de Mayocorreo_electronicostring
Example:
demo@gmail.comtelefonostring
Example:
427-1148totales
object
required
total_exportacionfloat
Example:
0total_operaciones_gravadasfloat
Example:
100total_operaciones_inafectasfloat
Example:
0total_operaciones_exoneradasfloat
Example:
0total_operaciones_gratuitasfloat
Example:
0total_igvfloat
Example:
18total_impuestosfloat
Example:
18total_valorfloat
Example:
100total_ventafloat
Example:
118items
object[]
required
codigo_internostring
Example:
P0121descripcionstring
Example:
Inca Kola 250 mlcodigo_producto_sunatstring
Example:
51121703unidad_de_medidastring
Example:
NIUcantidadint32
Example:
2valor_unitariofloat
Example:
50codigo_tipo_preciostring
Example:
01precio_unitariofloat
Example:
59codigo_tipo_afectacion_igvstring
Example:
10total_base_igvfloat
Example:
100porcentaje_igvfloat
Example:
18total_igvfloat
Example:
18total_impuestosfloat
Example:
18total_valor_itemfloat
Example:
100total_itemfloat
Example:
118informacion_adicionalstring
Example:
Forma de pago:Efectivo|Caja: 1Responses
- 200
- 400
- 422
JSON RESPUESTA
- application/json
- application/xml
- Schema
- Example (from schema)
Schema
successboolean
Example:
truedata
object
required
numberstring
Example:
F001-26filenamestring
Example:
20302019010-01-F001-26external_idstring
Example:
46c6ce9d-aaae-4b8d-8e94-a6f94c964b47state_type_idstring
Example:
05state_type_descriptionstring
Example:
Aceptadonumber_to_letterstring
Example:
Ciento dieciocho con 00/100hashstring
Example:
jFDgOlcAShjMeA1TJzT08v+PPTw=qrstring
Example:
iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAACzY+a1AAAACXBIWXMAAA7EAAAOxAGVKw4bAAAgAElEQVRDXEFRWtOsnuAAAAAElFTkSuQmCCidinteger
Example:
322links
object
xmlstring
Example:
https://demo.pro5.fastura.app/downloads/document/xml/46c6ce9d-aaae-4b8d-8e94-a6f94c964b47pdfstring
Example:
https://demo.pro5.fastura.app/downloads/document/pdf/46c6ce9d-aaae-4b8d-8e94-a6f94c964b47cdrstring
Example:
https://demo.pro5.fastura.app/downloads/document/cdr/46c6ce9d-aaae-4b8d-8e94-a6f94c964b47response
object
required
codestring
Example:
0descriptionstring
Example:
La Factura numero F001-26, ha sido aceptadanotesstring[]
{
"success": true,
"data": {
"number": "F001-26",
"filename": "20302019010-01-F001-26",
"external_id": "46c6ce9d-aaae-4b8d-8e94-a6f94c964b47",
"state_type_id": "05",
"state_type_description": "Aceptado",
"number_to_letter": "Ciento dieciocho con 00/100",
"hash": "jFDgOlcAShjMeA1TJzT08v+PPTw=",
"qr": "iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAACzY+a1AAAACXBIWXMAAA7EAAAOxAGVKw4bAAAgAElEQVRDXEFRWtOsnuAAAAAElFTkSuQmCC",
"id": 322
},
"links": {
"xml": "https://demo.pro5.fastura.app/downloads/document/xml/46c6ce9d-aaae-4b8d-8e94-a6f94c964b47",
"pdf": "https://demo.pro5.fastura.app/downloads/document/pdf/46c6ce9d-aaae-4b8d-8e94-a6f94c964b47",
"cdr": "https://demo.pro5.fastura.app/downloads/document/cdr/46c6ce9d-aaae-4b8d-8e94-a6f94c964b47"
},
"response": {
"code": "0",
"description": "La Factura numero F001-26, ha sido aceptada",
"notes": [
"string"
]
}
}
- Schema
- Example (from schema)
Schema
successboolean
Example:
truedata
object
required
numberstring
Example:
F001-26filenamestring
Example:
20302019010-01-F001-26external_idstring
Example:
46c6ce9d-aaae-4b8d-8e94-a6f94c964b47state_type_idstring
Example:
05state_type_descriptionstring
Example:
Aceptadonumber_to_letterstring
Example:
Ciento dieciocho con 00/100hashstring
Example:
jFDgOlcAShjMeA1TJzT08v+PPTw=qrstring
Example:
iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAACzY+a1AAAACXBIWXMAAA7EAAAOxAGVKw4bAAAgAElEQVRDXEFRWtOsnuAAAAAElFTkSuQmCCidinteger
Example:
322links
object
xmlstring
Example:
https://demo.pro5.fastura.app/downloads/document/xml/46c6ce9d-aaae-4b8d-8e94-a6f94c964b47pdfstring
Example:
https://demo.pro5.fastura.app/downloads/document/pdf/46c6ce9d-aaae-4b8d-8e94-a6f94c964b47cdrstring
Example:
https://demo.pro5.fastura.app/downloads/document/cdr/46c6ce9d-aaae-4b8d-8e94-a6f94c964b47response
object
required
codestring
Example:
0descriptionstring
Example:
La Factura numero F001-26, ha sido aceptadanotesstring[]
<root>
<success>true</success>
<data>
<number>F001-26</number>
<filename>20302019010-01-F001-26</filename>
<external_id>46c6ce9d-aaae-4b8d-8e94-a6f94c964b47</external_id>
<state_type_id>05</state_type_id>
<state_type_description>Aceptado</state_type_description>
<number_to_letter>Ciento dieciocho con 00/100</number_to_letter>
<hash>jFDgOlcAShjMeA1TJzT08v+PPTw=</hash>
<qr>iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAACzY+a1AAAACXBIWXMAAA7EAAAOxAGVKw4bAAAgAElEQVRDXEFRWtOsnuAAAAAElFTkSuQmCC</qr>
<id>322</id>
</data>
<links>
<xml>https://demo.pro5.fastura.app/downloads/document/xml/46c6ce9d-aaae-4b8d-8e94-a6f94c964b47</xml>
<pdf>https://demo.pro5.fastura.app/downloads/document/pdf/46c6ce9d-aaae-4b8d-8e94-a6f94c964b47</pdf>
<cdr>https://demo.pro5.fastura.app/downloads/document/cdr/46c6ce9d-aaae-4b8d-8e94-a6f94c964b47</cdr>
</links>
<response>
<code>0</code>
<description>La Factura numero F001-26, ha sido aceptada</description>
<notes>string</notes>
</response>
</root>
Invalid input
Validation exception