NOTA CRÉDITO - FACTURA
POST/api/documents
Una nota de crédito es un documento legal que se utiliza en transacciones de compraventa donde interviene un descuento posterior a la emisión de la factura, una anulación total, un cobro de un gasto incurrido de más, devolución de bienes.
Ejemplo:
- Método: POST
- URL: https://empresa1.demo3pro6.ibu.pe/api/documents
- TOKEN: HOHYgwd4atPalTxqi2IIspythpLAU7eP239oByfjk9VuveiOpfUTm4Yg0Szt
Request
- application/json
- application/xml
- application/x-www-form-urlencoded
Body
required
- JSON A ENVIAR
Array [
]
serie_documentostringrequired
Example:
FC01
numero_documentostringrequired
Example:
#
fecha_de_emisiondaterequired
Example:
2024-11-05
hora_de_emisiontime
Example:
10:11:11
codigo_tipo_documentostringrequired
Example:
07
codigo_tipo_notastring
Example:
01
motivo_o_sustento_de_notastring
Example:
Error al emitir comprobante
codigo_tipo_monedastring
Example:
PEN
numero_orden_de_comprastring
Example:
0045467898
documento_afectado
object
external_idstring
Example:
a7d75ecc-061d-46f6-8ee4-2521a5bbec1d
datos_del_cliente_o_receptor
object
codigo_tipo_documento_identidadstring
Example:
6
numero_documentostring
Example:
10414711225
apellidos_y_nombres_o_razon_socialstring
Example:
EMPRESA XYZ S.A.
codigo_paisstring
Example:
PE
ubigeostring
Example:
150101
direccionstring
Example:
Av. 2 de Mayo
correo_electronicostring
Example:
demo@gmail.com
telefonostring
Example:
427-1148
totales
object
total_exportacionfloat
Example:
0
total_operaciones_gravadasfloat
Example:
100
total_operaciones_inafectasfloat
Example:
0
total_operaciones_exoneradasfloat
Example:
0
total_operaciones_gratuitasfloat
Example:
0
total_igvfloat
Example:
18
total_impuestosfloat
Example:
18
total_valorfloat
Example:
100
total_ventafloat
Example:
118
items
object[]
codigo_internostring
Example:
P0121
descripcionstring
Example:
Inca Kola 250 ml
codigo_producto_sunatstring
Example:
unidad_de_medidastring
Example:
NIU
cantidadint32
Example:
2
valor_unitariofloat
Example:
50
codigo_tipo_preciostring
Example:
01
precio_unitariofloat
Example:
59
codigo_tipo_afectacion_igvstring
Example:
10
total_base_igvfloat
Example:
100
porcentaje_igvfloat
Example:
18
total_igvfloat
Example:
18
total_impuestosfloat
Example:
18
total_valor_itemfloat
Example:
100
total_itemfloat
Example:
118
Body
required
- JSON A ENVIAR
Array [
]
serie_documentostringrequired
Example:
FC01
numero_documentostringrequired
Example:
#
fecha_de_emisiondaterequired
Example:
2024-11-05
hora_de_emisiontime
Example:
10:11:11
codigo_tipo_documentostringrequired
Example:
07
codigo_tipo_notastring
Example:
01
motivo_o_sustento_de_notastring
Example:
Error al emitir comprobante
codigo_tipo_monedastring
Example:
PEN
numero_orden_de_comprastring
Example:
0045467898
documento_afectado
object
external_idstring
Example:
a7d75ecc-061d-46f6-8ee4-2521a5bbec1d
datos_del_cliente_o_receptor
object
codigo_tipo_documento_identidadstring
Example:
6
numero_documentostring
Example:
10414711225
apellidos_y_nombres_o_razon_socialstring
Example:
EMPRESA XYZ S.A.
codigo_paisstring
Example:
PE
ubigeostring
Example:
150101
direccionstring
Example:
Av. 2 de Mayo
correo_electronicostring
Example:
demo@gmail.com
telefonostring
Example:
427-1148
totales
object
total_exportacionfloat
Example:
0
total_operaciones_gravadasfloat
Example:
100
total_operaciones_inafectasfloat
Example:
0
total_operaciones_exoneradasfloat
Example:
0
total_operaciones_gratuitasfloat
Example:
0
total_igvfloat
Example:
18
total_impuestosfloat
Example:
18
total_valorfloat
Example:
100
total_ventafloat
Example:
118
items
object[]
codigo_internostring
Example:
P0121
descripcionstring
Example:
Inca Kola 250 ml
codigo_producto_sunatstring
Example:
unidad_de_medidastring
Example:
NIU
cantidadint32
Example:
2
valor_unitariofloat
Example:
50
codigo_tipo_preciostring
Example:
01
precio_unitariofloat
Example:
59
codigo_tipo_afectacion_igvstring
Example:
10
total_base_igvfloat
Example:
100
porcentaje_igvfloat
Example:
18
total_igvfloat
Example:
18
total_impuestosfloat
Example:
18
total_valor_itemfloat
Example:
100
total_itemfloat
Example:
118
Body
required
- JSON A ENVIAR
Array [
]
serie_documentostringrequired
Example:
FC01
numero_documentostringrequired
Example:
#
fecha_de_emisiondaterequired
Example:
2024-11-05
hora_de_emisiontime
Example:
10:11:11
codigo_tipo_documentostringrequired
Example:
07
codigo_tipo_notastring
Example:
01
motivo_o_sustento_de_notastring
Example:
Error al emitir comprobante
codigo_tipo_monedastring
Example:
PEN
numero_orden_de_comprastring
Example:
0045467898
documento_afectado
object
external_idstring
Example:
a7d75ecc-061d-46f6-8ee4-2521a5bbec1d
datos_del_cliente_o_receptor
object
codigo_tipo_documento_identidadstring
Example:
6
numero_documentostring
Example:
10414711225
apellidos_y_nombres_o_razon_socialstring
Example:
EMPRESA XYZ S.A.
codigo_paisstring
Example:
PE
ubigeostring
Example:
150101
direccionstring
Example:
Av. 2 de Mayo
correo_electronicostring
Example:
demo@gmail.com
telefonostring
Example:
427-1148
totales
object
total_exportacionfloat
Example:
0
total_operaciones_gravadasfloat
Example:
100
total_operaciones_inafectasfloat
Example:
0
total_operaciones_exoneradasfloat
Example:
0
total_operaciones_gratuitasfloat
Example:
0
total_igvfloat
Example:
18
total_impuestosfloat
Example:
18
total_valorfloat
Example:
100
total_ventafloat
Example:
118
items
object[]
codigo_internostring
Example:
P0121
descripcionstring
Example:
Inca Kola 250 ml
codigo_producto_sunatstring
Example:
unidad_de_medidastring
Example:
NIU
cantidadint32
Example:
2
valor_unitariofloat
Example:
50
codigo_tipo_preciostring
Example:
01
precio_unitariofloat
Example:
59
codigo_tipo_afectacion_igvstring
Example:
10
total_base_igvfloat
Example:
100
porcentaje_igvfloat
Example:
18
total_igvfloat
Example:
18
total_impuestosfloat
Example:
18
total_valor_itemfloat
Example:
100
total_itemfloat
Example:
118
Responses
- 200
- 400
- 422
JSON RESPUESTA
- application/json
- application/xml
- Schema
- Example (from schema)
Schema
successboolean
Example:
true
data
object
numberstring
Example:
FC01-3
filenamestring
Example:
11111111111-07-FC01-3
external_idstring
Example:
6269dbe8-9b32-4d43-b42f-81594a0a36cf
state_type_idstring
Example:
05
state_type_descriptionstring
Example:
Aceptado
number_to_letterstring
Example:
Ciento dieciocho con 00/100
hashstring
Example:
53iYvXndao4sSUP8XKrA/2aSjYk=
qrstring
Example:
iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAACzY+a1AAAACXBIWXMAAA7EAAAOxAGVKw4bAAAgAElEQVR4AQCbgGR/Af///wAAAMPNxEJsyosTAAAAAElFTkSuQmCC
idinteger
Example:
554
print_ticketstring
Example:
https://empresa1.demo3pro6.ibu.pe/print/document/6269dbe8-9b32-4d43-b42f-81594a0a36cf/ticket
links
object
xmlstring
Example:
https://empresa1.demo3pro6.ibu.pe/downloads/document/xml/6269dbe8-9b32-4d43-b42f-81594a0a36cf
pdfstring
Example:
https://empresa1.demo3pro6.ibu.pe/downloads/document/pdf/6269dbe8-9b32-4d43-b42f-81594a0a36cf
cdrstring
Example:
https://empresa1.demo3pro6.ibu.pe/downloads/document/cdr/6269dbe8-9b32-4d43-b42f-81594a0a36cf
response
object
codestring
Example:
0
descriptionstring
Example:
La Nota de Credito numero FC01-3, ha sido aceptada
notesarray
Example:
[]
{
"success": true,
"data": {
"number": "FC01-3",
"filename": "11111111111-07-FC01-3",
"external_id": "6269dbe8-9b32-4d43-b42f-81594a0a36cf",
"state_type_id": "05",
"state_type_description": "Aceptado",
"number_to_letter": "Ciento dieciocho con 00/100",
"hash": "53iYvXndao4sSUP8XKrA/2aSjYk=",
"qr": "iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAACzY+a1AAAACXBIWXMAAA7EAAAOxAGVKw4bAAAgAElEQVR4AQCbgGR/Af///wAAAMPNxEJsyosTAAAAAElFTkSuQmCC",
"id": 554,
"print_ticket": "https://empresa1.demo3pro6.ibu.pe/print/document/6269dbe8-9b32-4d43-b42f-81594a0a36cf/ticket"
},
"links": {
"xml": "https://empresa1.demo3pro6.ibu.pe/downloads/document/xml/6269dbe8-9b32-4d43-b42f-81594a0a36cf",
"pdf": "https://empresa1.demo3pro6.ibu.pe/downloads/document/pdf/6269dbe8-9b32-4d43-b42f-81594a0a36cf",
"cdr": "https://empresa1.demo3pro6.ibu.pe/downloads/document/cdr/6269dbe8-9b32-4d43-b42f-81594a0a36cf"
},
"response": {
"code": "0",
"description": "La Nota de Credito numero FC01-3, ha sido aceptada",
"notes": []
}
}
- Schema
- Example (from schema)
Schema
successboolean
Example:
true
data
object
numberstring
Example:
FC01-3
filenamestring
Example:
11111111111-07-FC01-3
external_idstring
Example:
6269dbe8-9b32-4d43-b42f-81594a0a36cf
state_type_idstring
Example:
05
state_type_descriptionstring
Example:
Aceptado
number_to_letterstring
Example:
Ciento dieciocho con 00/100
hashstring
Example:
53iYvXndao4sSUP8XKrA/2aSjYk=
qrstring
Example:
iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAACzY+a1AAAACXBIWXMAAA7EAAAOxAGVKw4bAAAgAElEQVR4AQCbgGR/Af///wAAAMPNxEJsyosTAAAAAElFTkSuQmCC
idinteger
Example:
554
print_ticketstring
Example:
https://empresa1.demo3pro6.ibu.pe/print/document/6269dbe8-9b32-4d43-b42f-81594a0a36cf/ticket
links
object
xmlstring
Example:
https://empresa1.demo3pro6.ibu.pe/downloads/document/xml/6269dbe8-9b32-4d43-b42f-81594a0a36cf
pdfstring
Example:
https://empresa1.demo3pro6.ibu.pe/downloads/document/pdf/6269dbe8-9b32-4d43-b42f-81594a0a36cf
cdrstring
Example:
https://empresa1.demo3pro6.ibu.pe/downloads/document/cdr/6269dbe8-9b32-4d43-b42f-81594a0a36cf
response
object
codestring
Example:
0
descriptionstring
Example:
La Nota de Credito numero FC01-3, ha sido aceptada
notesarray
Example:
[]
<root>
<success>true</success>
<data>
<number>FC01-3</number>
<filename>11111111111-07-FC01-3</filename>
<external_id>6269dbe8-9b32-4d43-b42f-81594a0a36cf</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>53iYvXndao4sSUP8XKrA/2aSjYk=</hash>
<qr>iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAACzY+a1AAAACXBIWXMAAA7EAAAOxAGVKw4bAAAgAElEQVR4AQCbgGR/Af///wAAAMPNxEJsyosTAAAAAElFTkSuQmCC</qr>
<id>554</id>
<print_ticket>https://empresa1.demo3pro6.ibu.pe/print/document/6269dbe8-9b32-4d43-b42f-81594a0a36cf/ticket</print_ticket>
</data>
<links>
<xml>https://empresa1.demo3pro6.ibu.pe/downloads/document/xml/6269dbe8-9b32-4d43-b42f-81594a0a36cf</xml>
<pdf>https://empresa1.demo3pro6.ibu.pe/downloads/document/pdf/6269dbe8-9b32-4d43-b42f-81594a0a36cf</pdf>
<cdr>https://empresa1.demo3pro6.ibu.pe/downloads/document/cdr/6269dbe8-9b32-4d43-b42f-81594a0a36cf</cdr>
</links>
<response>
<code>0</code>
<description>La Nota de Credito numero FC01-3, ha sido aceptada</description>
</response>
</root>
Invalid input
Validation exception