A continuación te explicaremos cómo debes construir el archivo JSON cuando necesites hacer uso de una addenda comercial.
Teniendo como base la estructura principal de un archivo JSON para la emisión de un CFDI simple, debemos identificar a nivel de concepto y a nivel del documento las etiquetas llamadas "addendas", en este ejemplo se encontrarán sombreadas en color amarillo.
- {
"origen": "3",
"doctype": "FACTURA",
"numero_interno": "",
"nota_comprobante_cabecera": "NOTA DE CABECERA",
"nota_comprobante_pie": "NOTA DE PIE",
"usuario": "",
"emisor": {
"rfc": "JES900109Q90",
"razon_social": "SUPER EMPRESA INVALIDA S.A DE C. V.",
"direccion_fiscal": {
"calle": "MATIAS ROMERO",
"num_exterior": "216",
"num_interior": "",
"colonia": "DEL VALLE",
"municipio": "BENITO JUAREZ",
"estado": "CDMX",
"pais": "MEXICO",
"codigo_postal": "03100",
"localidad": "",
"referencia": ""
},
"regimen_fiscal": "601",
"lugar_expedicion": "03100",
"sucursal": "ABB",
"correo": "soporte@mysuitemex.com",
"cuenta_pago": ""
},
"receptor": {
"rfc": "MAB911203RR7",
"razon_social": "MABE SA DE CV",
"rfc_extranjero": "",
"residencia_fiscal": "",
"correo": "soporte@mysuitemex.com",
"direccion_fiscal": {
"calle": "ORIENTE 162",
"num_exterior": "296",
"num_interior": "",
"colonia": "MOCTEZUMA 2da SECCION",
"municipio": "VENUSTIANO CARRANZA",
"estado": "Ciudad de México",
"pais": "MEXICO",
"codigo_postal": "15500",
"localidad": "MEXICO",
"referencia": ""
},
"uso_cfdi": "G01"
},
"conceptos": [
{
"UUID": "d1ce720e-1d3c-4986-a537-a46e016e52e8",
"ID": 154,
"Description": "CAMISA DE VESTIR MANGA LARGA",
"ListPrice": "50.00",
"Discount": "0.00",
"Unit": "UN",
"ClaveProdServ": "53102601",
"ClaveUnidad": "BTU",
"InfoAduanera": "",
"CuentaPredial": "0232123",
"Qty": "2",
"Amount": "100.00",
"Identificacion": "000121",
"complementos": null,
"addendas": null,
"Taxes": [
{
"UUID": "1ba9c9b3-bbe5-4422-89c1-048d6cffc1b2",
"type": "TRASLADO",
"impuesto": "002",
"tipofactor": "Tasa",
"tasacuota": "0.160000",
"taxbase": "100",
"amount": "16.00"
}
],
"Partes": [
{
"UUID": "7110c041-55c8-4482-ac2f-3b997d135455",
"ClaveProdServ": "53102601",
"Identificacion": "0002",
"Qty": "2",
"Unit": "UN",
"Description": "Pijamas o camisas de dormir o batas para niño",
"UnitPrice": "40.00",
"Amount": "80.00",
"InfoAduanera": ""
}
],
"Descripcion_Ampliada": "wsdsddsdsd /n jdsdjshdjsdhsdjhd"
}
],
"totales": {
"total": "116.00",
"subtotal": "100.00",
"descuento": "0.00",
"moneda": "MXN|2",
"factor_cambio": "1",
"impuestos_trasladados": "16.00",
"impuestos_retenidos": "0.00"
},
"fecha_emision": "",
"serie": "A",
"folio": "1",
"metodo_pago": "PUE",
"forma_pago": "01",
"confirmacion": "",
"condiciones_pago": "3 MESES",
"cfdi_relacionados": {
"tipo_relacion": "01",
"listado_folios": "1b0678c2-e285-41aa-a232-928a165d71dc"
},
"complementos": null,
"addendas": null
}
Ya que las haya identificado, ahora debe agregar en estas mismas la siguiente información:
"addendas" a nivel de concepto:
- "addendas": [
{
"name": "mabe",
"content": "Base64 de la estructura JSON proporcionada por MYSuite"
}
],
"addendas" a nivel del documento:
- "addendas": [
{
"name": "mabe",
"content": "Base64 de la estructura JSON proporcionada por MYSuite"
}
]
Al ser la etiqueta "addendas" (a nivel del documento), el último elemento en la estructura del JSON, note que en esta ya no deberá llevar la coma (,) al final.
Para saber qué debe expresar en cada etiqueta, le mostramos a continuación lo que se solicita en la estructura de JSON a nivel de concepto y que debe estar codificado en Base64:
- {
"use_tax":true,
"use_discount":true
}
Para saber qué debe expresar en cada etiqueta, le mostramos a
continuación lo que se solicita en la estructura de JSON a nivel del documento y que debe estar codificado en Base64:
- {
"proveedor": "r_valor",
"orden_compra": "r_valor",
"referencia1": "r_valor",
"referencia2": "valor",
"entrega": {
"planta_entrega": "r_valor",
"calle": "r_valor",
"numero_interior": "valor",
"numero_exterior": "r_valor",
"codigo_postal":"r_valor"
}
}
A continuación mostramos cómo debe quedar estructurado su archivo JSON ya con las etiquetas de addenda:
- {
"origen": "3",
"doctype": "FACTURA",
"numero_interno": "",
"nota_comprobante_cabecera": "NOTA DE CABECERA",
"nota_comprobante_pie": "NOTA DE PIE",
"usuario": "",
"emisor": {
"rfc": "JES900109Q90",
"razon_social": "SUPER EMPRESA INVALIDA S.A DE C. V.",
"direccion_fiscal": {
"calle": "MATIAS ROMERO",
"num_exterior": "216",
"num_interior": "",
"colonia": "DEL VALLE",
"municipio": "BENITO JUAREZ",
"estado": "CDMX",
"pais": "MEXICO",
"codigo_postal": "03100",
"localidad": "",
"referencia": ""
},
"regimen_fiscal": "601",
"lugar_expedicion": "03100",
"sucursal": "ABB",
"correo": "soporte@mysuitemex.com",
"cuenta_pago": ""
},
"receptor": {
"rfc": "MAB911203RR7",
"razon_social": "MABE SA DE CV",
"rfc_extranjero": "",
"residencia_fiscal": "",
"correo": "soporte@mysuitemex.com",
"direccion_fiscal": {
"calle": "ORIENTE 162",
"num_exterior": "296",
"num_interior": "",
"colonia": "MOCTEZUMA 2da SECCION",
"municipio": "VENUSTIANO CARRANZA",
"estado": "Ciudad de México",
"pais": "MEXICO",
"codigo_postal": "15500",
"localidad": "MEXICO",
"referencia": ""
},
"uso_cfdi": "G01"
},
"conceptos": [
{
"UUID": "d1ce720e-1d3c-4986-a537-a46e016e52e8",
"ID": 154,
"Description": "CAMISA DE VESTIR MANGA LARGA",
"ListPrice": "50.00",
"Discount": "0.00",
"Unit": "UN",
"ClaveProdServ": "53102601",
"ClaveUnidad": "BTU",
"InfoAduanera": "",
"CuentaPredial": "0232123",
"Qty": "2",
"Amount": "100.00",
"Identificacion": "000121",
"complementos": null,
"addendas": [
{
"name": "mabe",
"content": "Base64 de la estructura JSON proporcionada por MYSuite"
}
],
"Taxes": [
{
"UUID": "1ba9c9b3-bbe5-4422-89c1-048d6cffc1b2",
"type": "TRASLADO",
"impuesto": "002",
"tipofactor": "Tasa",
"tasacuota": "0.160000",
"taxbase": "100",
"amount": "16.00"
}
],
"Partes": [
{
"UUID": "7110c041-55c8-4482-ac2f-3b997d135455",
"ClaveProdServ": "53102601",
"Identificacion": "0002",
"Qty": "2",
"Unit": "UN",
"Description": "Pijamas o camisas de dormir o batas para niño",
"UnitPrice": "40.00",
"Amount": "80.00",
"InfoAduanera": ""
}
],
"Descripcion_Ampliada": "wsdsddsdsd /n jdsdjshdjsdhsdjhd"
}
],
"totales": {
"total": "116.00",
"subtotal": "100.00",
"descuento": "0.00",
"moneda": "MXN|2",
"factor_cambio": "1",
"impuestos_trasladados": "16.00",
"impuestos_retenidos": "0.00"
},
"fecha_emision": "",
"serie": "A",
"folio": "1",
"metodo_pago": "PUE",
"forma_pago": "01",
"confirmacion": "",
"condiciones_pago": "3 MESES",
"cfdi_relacionados": {
"tipo_relacion": "01",
"listado_folios": "1b0678c2-e285-41aa-a232-928a165d71dc"
},
"complementos": null,
"addendas": [
{
"name": "mabe",
"content": "Base64 de la estructura JSON proporcionada por MYSuite"
}
]
}
No todas las addendas llevan estructura a nivel de concepto, en caso de que se encuentre con alguna así, sólo debe expresar a nivel del documento la estructura de addenda y dejar con valor null la etiqueta a nivel de concepto:
"addendas": null,
A continuación se adjuntan todas las addendas comerciales que actualmente tenemos en el servicio EndPoint.
En caso de no encontrar alguna, por favor indíquelo a través de un ticket en el siguiente enlace:
Related Articles
JSON con Addenda
A continuación te explicaremos cómo debes construir el archivo JSON cuando necesites hacer uso de una addenda comercial. Teniendo como base la estructura principal de un archivo JSON para la emisión de un CFDI simple, debemos identificar a nivel de ...
JSON con Complementos
A continuación te explicaremos cómo debes construir el archivo JSON cuando necesites hacer uso de un complemento fiscal. Teniendo como base la estructura principal de un archivo JSON para la emisión de un CFDI simple, debemos identificar a nivel de ...
JSON con Complementos
A continuación te explicaremos cómo debes construir el archivo JSON cuando necesites hacer uso de un complemento fiscal. Teniendo como base la estructura principal de un archivo JSON para la emisión de un CFDI simple, debemos identificar a nivel de ...
INTEGRACIÓN ADDENDAS COMERCIALES
Este documento tiene como objetivo, ayudar a los clientes, a través de su área de integración (sistemas), a implementar las Addendas Comerciales que hoy día se tienen disponibles en MYSuite. En cada hoja de este documento de Excel (que se encuentra ...
FIRMAR_RETENCION
En MYSuite podrás utilizar este método que te ayudara a realizar un comprobante de retenciones conforme lo marca el Anexo 20 vigente. Solicitud Request URL: https://api.mysuitetest.com/RequestTransaction Valores { "Requestor": "string", ...