Envio - Documentación

POST

invoice

send

curl --request POST \
  --url https://apife-qa.factiliza.com/api/v1/invoice/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "tipo_Operacion": "<string>",
  "tipo_Doc": "<string>",
  "serie": "<string>",
  "correlativo": "<string>",
  "tipo_Moneda": "<string>",
  "fecha_Emision": "2023-11-07T05:31:56Z",
  "empresa_Ruc": "<string>",
  "cliente_Tipo_Doc": "<string>",
  "cliente_Num_Doc": "<string>",
  "cliente_Razon_Social": "<string>",
  "cliente_Direccion": "<string>",
  "monto_Oper_Gravadas": 123,
  "monto_Igv": 123,
  "total_Impuestos": 123,
  "valor_Venta": 123,
  "sub_Total": 123,
  "monto_Imp_Venta": 123,
  "monto_Oper_Exoneradas": 123,
  "estado_Documento": "<string>",
  "manual": true,
  "id_Base_Dato": "<string>",
  "detalle": [
    {
      "unidad": "<string>",
      "cantidad": 123,
      "cod_Producto": "<string>",
      "descripcion": "<string>",
      "monto_Valor_Unitario": 123,
      "monto_Base_Igv": 123,
      "porcentaje_Igv": 123,
      "igv": 123,
      "tip_Afe_Igv": "<string>",
      "total_Impuestos": 123,
      "monto_Precio_Unitario": 123,
      "monto_Valor_Venta": 123,
      "factor_Icbper": 123
    }
  ],
  "forma_pago": [
    {
      "tipo": "<string>",
      "monto": 123,
      "cuota": 123,
      "fecha_Pago": "2023-11-07T05:31:56Z"
    }
  ],
  "legend": [
    {
      "legend_Code": "<string>",
      "legend_Value": "<string>"
    }
  ]
}'

{
  "status": 200,
  "success": true,
  "message": "DEMO - El documento fue registrado en el sistema y se encuentra declarado correctamente validado en la sunat!",
  "data": {
    "hash": "AeOqQVd8d5kfPS+CmeCMF+NNMpI=",
    "sunatResponse": {
      "success": true,
      "cdrZip": "UEsDBBQAAgAIALpqtlgAAAAAAgAAAAAAAAAGAAAAZHVtbXkvAwBQSwMEFAACAAgAumq2WPsmw/E/BAAAJw0AACAAAABSLTIwMTM4ODUxNDEwLTAzLUJWMDEtMDAwMDIyLnhtbLVXW3PaOhB+76/wwENn2jqyzaXgMXQg5EJPkuZwSXPOm7AFeGJLriQDya8/KxtfIM40dOZM8iDvfvvt7qeVNDjfdmGgbQgXPqO9mnlm1DRCXeb5dNWrzWeXeqf2rf/BwdweRFHgu1gCcEJExKggGgRT0avFnNoMC1/YFIdE2CIirr/cg+14EdjCXZMQ2zvh2WO6Yb5LdKuWhtuYn8hQUUnBRnbyRLpzFoaMXuwkoUoF+ARKQqUoSN2F+0ekQ4C7lYT4zwgHqxUnKyxJFakHW7GWMrIR2m63Z9vGGeMrZBmGgYwuAown/FU9QwuGoxyfJhJn4FL2JFAtEKEbErCIoDwJJM/DyE4EMgErs9Ax9XTpQy95kqxPEVMs3+wzIjwuNztV6KpezYx491avJnq8vZkmVBkWWMguqigaHHGAuQ5eToTafFHrOzBB9nx4kw+EyMa8wpdaSrNDYSX7ztRfQQcxz4/IO/YFjpkKI96YLln/g6Y555gyCjoF/kui1S2Ra+Zpg2DFuC/X4ZsSmIaihb5c3TWbtP4T0GqAlIY1lHDnFb6b1Ghmteoh46TOBdbFGrdMa085IUvC4fYg2nwyVnKBEcwzjqlYMh6K1FA2/TbtgUTZMHq6yKpPU59I+h6BgBAdV+6M/BUR8kTFQJF6Waec5wEHMelPn4Zf/7mmi6fN4rN3Jf6+fJj500Zj1b1G30ePg8+s/WMYL3/8Mrbs6tej9XJzOX++ldvr2bTZmVxdfJ+Of47mbb64WP47YI/tTXN5M3/Z9noOKmdR+4PyDYJRQ4ezVp6INOLTPfc3cPq0J/KsfRwSie/hqMJ1Rrj8qFEmtTj6lNKUopy/yHPC6Ty2jO4IS5yuVFR65oH5Dq4BT3ML054/TQgMJf7j4IRtLERM+JRwHwdliyI+nb4Um3ClvHdxuCD8dLaD6HKCrFxUKINytQodYV19p6DXl88rk+g78FYp00P6po9HfevMcNAra4I7j4Vk4f52AaOZQY8dCVoBvprtRrcDs9wyzBSae1WTI7VFlmE1dcPSLWtmGLbZthvNPTSHFBEzeC76AEv+S7DEnsCyN77E3QLuFHvgPIAnBGbDtky7dQTec2PXLqm+70VZpvO7wazUXQ5k/Pkec/mc2pLl2IPNyV+znMYyzAb8Wd1WqyBCb0dljnQKVUCyKlWSetAREr1VHBx+X+Igb3AgJXbXYTJJyq9GhlMcFHdCOjmTcb9+pIGypYkqgtDvkqFjndUnoR7h/4+UqDLBhLjE35yUswNj3jSNd+esSDFibqxUyAYvqyX/SoZyryWkGD4Ypg6PnlGMd+E8mO5z5sGxORzrxJagRkS43I+S4m6wNmQB3FgahVo400pJvmhrrAnfYxp2SSSxh1PGcnzWXLmDoq+D4anqIBeuKiZVzY98sL9zZ9o67A08rk2r2+mesjcHWVD17qDq3zn9/wBQSwECAAAUAAIACAC6arZYAAAAAAIAAAAAAAAABgAAAAAAAAAAAAAAAAAAAAAAZHVtbXkvUEsBAgAAFAACAAgAumq2WPsmw/E/BAAAJw0AACAAAAAAAAAAAQAAAAAAJgAAAFItMjAxMzg4NTE0MTAtMDMtQlYwMS0wMDAwMjIueG1sUEsFBgAAAAACAAIAggAAAKMEAAAAAA==",
      "cdrResponse": {
        "id": "BV01-000022",
        "code": "0",
        "description": "La Boleta numero BV01-000022, ha sido aceptada",
        "notes": []
      }
    }
  }
}

{
    "tipo_Operacion": "0101",
    "tipo_Doc": "01",
    "serie": "F001",
    "correlativo": "1",
    "tipo_Moneda": "PEN",
    "fecha_Emision": "2025-01-01T00:00:00-05:00",

    "empresa_Ruc": "20607086215",

    "cliente_Tipo_Doc": "6",
    "cliente_Num_Doc": "20552103816",
    "cliente_Razon_Social": "AGROLIGHT PERU S.A.C.",
    "cliente_Direccion": "PJ. JORGE BASADRE NRO. 158, LIMA - LIMA - SANTA ANITA",

    "monto_Oper_Gravadas": 100,
    "monto_Igv": 18,
    "total_Impuestos": 18,
    "valor_Venta": 100,
    "sub_Total": 118,
    "monto_Imp_Venta": 118,

    "monto_Oper_Exoneradas":0,

    "estado_Documento": "0", //Por defecto en 0
    "manual": false, //Por defecto en false 
    "id_Base_Dato": "15265",//ID de base de datos (opcional)

    "detalle": [
        {
            "unidad": "NIU",
            "cantidad": 1,
            "cod_Producto": "CDFG",
            "descripcion": "PRODUCTO 1",
            "monto_Valor_Unitario": 100.00,
            "monto_Base_Igv": 100.00,
            "porcentaje_Igv": 18.00,
            "igv": 18,
            "tip_Afe_Igv": "10",
            "total_Impuestos": 18.00,
            "monto_Precio_Unitario": 118.00,
            "monto_Valor_Venta": 100.00,
            "factor_Icbper":0
        }
    ],
    "forma_pago": [
        {
            "tipo": "Contado",
            "monto": 118,
            "cuota": 0,
            "fecha_Pago": "2024-02-02T00:00:00-05:00"
        }
    ],
    "legend": [
        {
            "legend_Code": "1000",
            "legend_Value": "SON CIENTO DIECIOCHO CON 00/100 SOLES"
        }
    ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Plant to add to the store

tipo_Operacion

string

required

Catálogo No. 51: Código de tipo de operación (catalogo-sunat)

tipo_Doc

string

required

Tipo de documento ("01" es factura y "03" es boleta)

serie

string

required

Serie del documento

correlativo

string

required

Correlativo del documento

tipo_Moneda

string

required

Código de la moneda, según sunat, por ejemplo "PEN"

fecha_Emision

string

required

Fecha en la que fue emitida la boleta

empresa_Ruc

string

required

Ruc de la empresa emisora

cliente_Tipo_Doc

string

required

Catálogo No. 06: Códigos de Tipos de Documentos de Identidad (catalogo-sunat)

cliente_Num_Doc

string

required

Número de documento del cliente, en base al tipo de documento

Razon social del cliente

cliente_Direccion

string

required

Direccion del cliente

monto_Oper_Gravadas

number

required

Monto de operaciones gravadas

monto_Igv

number

required

Monto del IGV total del documento

total_Impuestos

number

required

Monto del total de impuesto del documento

valor_Venta

number

required

Monto de valor de venta del documento

sub_Total

number

required

Sub total del documento

monto_Imp_Venta

number

required

Monto de importe de venta

detalle

object[]

required

Lista de productos

forma_pago

object[]

required

Lista de formas de pago

legend

object[]

required

Lista de leyendas

monto_Oper_Exoneradas

number

Monto de operaciones exoneradas

estado_Documento

string

Siempre sera en 0 si es que quieres que se declare de inmediato ni bien se envia

manual

boolean

Siempre será false porque se integra via al API de Facturación.

id_Base_Dato

string

ID único de tu base de datos del Sistema donde se envía el documento

Response

200

application/json

message response

status

integer

required

success

boolean

required

message

string

required

data

object

required

PDF Documento

curl --request POST \
  --url https://apife-qa.factiliza.com/api/v1/invoice/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "tipo_Operacion": "<string>",
  "tipo_Doc": "<string>",
  "serie": "<string>",
  "correlativo": "<string>",
  "tipo_Moneda": "<string>",
  "fecha_Emision": "2023-11-07T05:31:56Z",
  "empresa_Ruc": "<string>",
  "cliente_Tipo_Doc": "<string>",
  "cliente_Num_Doc": "<string>",
  "cliente_Razon_Social": "<string>",
  "cliente_Direccion": "<string>",
  "monto_Oper_Gravadas": 123,
  "monto_Igv": 123,
  "total_Impuestos": 123,
  "valor_Venta": 123,
  "sub_Total": 123,
  "monto_Imp_Venta": 123,
  "monto_Oper_Exoneradas": 123,
  "estado_Documento": "<string>",
  "manual": true,
  "id_Base_Dato": "<string>",
  "detalle": [
    {
      "unidad": "<string>",
      "cantidad": 123,
      "cod_Producto": "<string>",
      "descripcion": "<string>",
      "monto_Valor_Unitario": 123,
      "monto_Base_Igv": 123,
      "porcentaje_Igv": 123,
      "igv": 123,
      "tip_Afe_Igv": "<string>",
      "total_Impuestos": 123,
      "monto_Precio_Unitario": 123,
      "monto_Valor_Venta": 123,
      "factor_Icbper": 123
    }
  ],
  "forma_pago": [
    {
      "tipo": "<string>",
      "monto": 123,
      "cuota": 123,
      "fecha_Pago": "2023-11-07T05:31:56Z"
    }
  ],
  "legend": [
    {
      "legend_Code": "<string>",
      "legend_Value": "<string>"
    }
  ]
}'

{
  "status": 200,
  "success": true,
  "message": "DEMO - El documento fue registrado en el sistema y se encuentra declarado correctamente validado en la sunat!",
  "data": {
    "hash": "AeOqQVd8d5kfPS+CmeCMF+NNMpI=",
    "sunatResponse": {
      "success": true,
      "cdrZip": "UEsDBBQAAgAIALpqtlgAAAAAAgAAAAAAAAAGAAAAZHVtbXkvAwBQSwMEFAACAAgAumq2WPsmw/E/BAAAJw0AACAAAABSLTIwMTM4ODUxNDEwLTAzLUJWMDEtMDAwMDIyLnhtbLVXW3PaOhB+76/wwENn2jqyzaXgMXQg5EJPkuZwSXPOm7AFeGJLriQDya8/KxtfIM40dOZM8iDvfvvt7qeVNDjfdmGgbQgXPqO9mnlm1DRCXeb5dNWrzWeXeqf2rf/BwdweRFHgu1gCcEJExKggGgRT0avFnNoMC1/YFIdE2CIirr/cg+14EdjCXZMQ2zvh2WO6Yb5LdKuWhtuYn8hQUUnBRnbyRLpzFoaMXuwkoUoF+ARKQqUoSN2F+0ekQ4C7lYT4zwgHqxUnKyxJFakHW7GWMrIR2m63Z9vGGeMrZBmGgYwuAown/FU9QwuGoxyfJhJn4FL2JFAtEKEbErCIoDwJJM/DyE4EMgErs9Ax9XTpQy95kqxPEVMs3+wzIjwuNztV6KpezYx491avJnq8vZkmVBkWWMguqigaHHGAuQ5eToTafFHrOzBB9nx4kw+EyMa8wpdaSrNDYSX7ztRfQQcxz4/IO/YFjpkKI96YLln/g6Y555gyCjoF/kui1S2Ra+Zpg2DFuC/X4ZsSmIaihb5c3TWbtP4T0GqAlIY1lHDnFb6b1Ghmteoh46TOBdbFGrdMa085IUvC4fYg2nwyVnKBEcwzjqlYMh6K1FA2/TbtgUTZMHq6yKpPU59I+h6BgBAdV+6M/BUR8kTFQJF6Waec5wEHMelPn4Zf/7mmi6fN4rN3Jf6+fJj500Zj1b1G30ePg8+s/WMYL3/8Mrbs6tej9XJzOX++ldvr2bTZmVxdfJ+Of47mbb64WP47YI/tTXN5M3/Z9noOKmdR+4PyDYJRQ4ezVp6INOLTPfc3cPq0J/KsfRwSie/hqMJ1Rrj8qFEmtTj6lNKUopy/yHPC6Ty2jO4IS5yuVFR65oH5Dq4BT3ML054/TQgMJf7j4IRtLERM+JRwHwdliyI+nb4Um3ClvHdxuCD8dLaD6HKCrFxUKINytQodYV19p6DXl88rk+g78FYp00P6po9HfevMcNAra4I7j4Vk4f52AaOZQY8dCVoBvprtRrcDs9wyzBSae1WTI7VFlmE1dcPSLWtmGLbZthvNPTSHFBEzeC76AEv+S7DEnsCyN77E3QLuFHvgPIAnBGbDtky7dQTec2PXLqm+70VZpvO7wazUXQ5k/Pkec/mc2pLl2IPNyV+znMYyzAb8Wd1WqyBCb0dljnQKVUCyKlWSetAREr1VHBx+X+Igb3AgJXbXYTJJyq9GhlMcFHdCOjmTcb9+pIGypYkqgtDvkqFjndUnoR7h/4+UqDLBhLjE35yUswNj3jSNd+esSDFibqxUyAYvqyX/SoZyryWkGD4Ypg6PnlGMd+E8mO5z5sGxORzrxJagRkS43I+S4m6wNmQB3FgahVo400pJvmhrrAnfYxp2SSSxh1PGcnzWXLmDoq+D4anqIBeuKiZVzY98sL9zZ9o67A08rk2r2+mesjcHWVD17qDq3zn9/wBQSwECAAAUAAIACAC6arZYAAAAAAIAAAAAAAAABgAAAAAAAAAAAAAAAAAAAAAAZHVtbXkvUEsBAgAAFAACAAgAumq2WPsmw/E/BAAAJw0AACAAAAAAAAAAAQAAAAAAJgAAAFItMjAxMzg4NTE0MTAtMDMtQlYwMS0wMDAwMjIueG1sUEsFBgAAAAACAAIAggAAAKMEAAAAAA==",
      "cdrResponse": {
        "id": "BV01-000022",
        "code": "0",
        "description": "La Boleta numero BV01-000022, ha sido aceptada",
        "notes": []
      }
    }
  }
}

API Facturación

Authorizations

Body

Response