Examples by country🇲🇽 Mexico

➕ Create new documents

Invoice

In order to create a new mexican invoice, you need to use the /documents endpoint with the proper parameters.

Mexican invoices can be type I, E or T. To define which type to use, please check the document_type_id field proper values.

1{
2  "header": {
3    "account_id": 141,
4    "document_type_id": "76",
5
6    "received_issued_flag": 1,
7    "issue_date": "2025-01-07",
8    "issuer_tax_id_code": "EKU9003173C9",
9    "issuer_tax_id_type": "MX-RFC",
10    "issuer_legal_name": "<string>",
11    "issuer_address": "<string>",
12    "issuer_district": "<string>",
13    "issuer_city": "<string>",
14    "issuer_country_id": "80",
15    "issuer_phone": "<string>",
16    "issuer_activity": "<string>",
17    "receiver_tax_id_code": "EKU9003173C9",
18    "receiver_tax_id_type": "MX-RFC",
19    "receiver_legal_name": "ESCUELA KEMPER URGATE",
20    "receiver_address": "<string>",
21    "receiver_district": "<string>",
22    "receiver_city": "<string>",
23    "receiver_country_id": "80",
24    "receiver_phone": "<string>",
25    "receiver_activity": "<string>",
26    "payment_conditions": "0",
27    "currency_id": 31
28
29  },
30  "details": [
31    {
32      "quantity": 1,
33      "sku": "aa111",
34      "line_description": "Prueba Koywe",
35      "unit_measure": "UN",
36      "unit_price": 1500,
37      "long_description": "Esta es una linea de prueba",
38      "modifier_amount": -100,
39      "total_taxes": 224,
40      "modifier_percentage": 0,
41      "total_amount_line": 1624,
42      "taxes": [
43        {
44          "tax_type_id": "362",
45          "tax_percentage": 16,
46          "tax_amount": 224
47        }
48      ]
49    }
50  ],
51  "totals": {
52    "net_amount": 1400,
53    "taxes_amount": 224,
54    "total_amount": 1624
55  }
56}

Invoice with bill of lading complement

In order to create a new mexican invoice with bill of lading complement, you need to use the /documents endpoint with the proper parameters.

1{
2  "header": {
3    "account_id": 141,
4    "document_type_id": "76",
5
6    "received_issued_flag": 1,
7    "issue_date": "2025-01-07",
8    "issuer_tax_id_code": "EKU9003173C9",
9    "issuer_tax_id_type": "MX-RFC",
10    "issuer_legal_name": "<string>",
11    "issuer_address": "<string>",
12    "issuer_district": "<string>",
13    "issuer_city": "<string>",
14    "issuer_country_id": "80",
15    "issuer_phone": "<string>",
16    "issuer_activity": "<string>",
17    "receiver_tax_id_code": "EKU9003173C9",
18    "receiver_tax_id_type": "MX-RFC",
19    "receiver_legal_name": "ESCUELA KEMPER URGATE",
20    "receiver_address": "<string>",
21    "receiver_district": "<string>",
22    "receiver_city": "<string>",
23    "receiver_country_id": "80",
24    "receiver_phone": "<string>",
25    "receiver_activity": "<string>",
26    "payment_conditions": "0",
27    "currency_id": 31,
28    "additional": {
29        "mx_shipping": {
30            "distance": "100",
31            "transport_code": "01",
32            "transport_method_name": "Autotransporte",
33            "transport_tax_id_type": "MX-RFC",
34            "transport_tax_id_code": "EKU9003173C9",
35            "transport_license": "a234567890",
36            "origin": {
37                "tax_id_type" : "MX-RFC",
38                "tax_id_code": "EKU9003173C9",
39                "date_time": "2025-01-07T00:00:00",
40                "address_state_id": "31",
41                "address_country_id": "80",
42                "address_postalcode": "13250"
43            },
44            "destination": {
45                "tax_id_type" : "MX-RFC",
46                "tax_id_code": "EKU9003173C9",
47                "date_time": "2025-01-07T00:00:00",
48                "address_state_id": "31",
49                "address_country_id": "80",
50                "address_postalcode": "13250"
51            },
52            "merchandise": {
53                "total_weight": "10",
54                "sct_permission_code": "TPAF01",
55                "sct_permission_number": "222333444",
56                "vehicle_configuration": "VL",
57                "vehicle_weight": "1",
58                "vehicle_license_plate": "AA22333",
59                "vehicle_year":"2020",
60                "insurance_company": "PRUEBA SEGUROS",
61                "insurance_identifier": "123456",
62                "details": [
63                    {
64                        "product_code": "11121900",
65                        "description" : "Accesorios telefono",
66                        "quantity" : "1",
67                        "weight": "10"
68                    }
69                ]
70            }
71        }
72
73      }
74
75  },
76
77  "details": [
78    {
79      "quantity": 1,
80      "line_description": "Prueba Koywe",
81      "unit_measure": "UN",
82      "unit_price": 1500,
83      "long_description": "Esta es una linea de prueba",
84      "modifier_amount": -100,
85      "total_taxes": 224,
86      "modifier_percentage": 0,
87      "total_amount_line": 1624,
88      "taxes": [
89        {
90          "tax_type_id": "362",
91          "tax_percentage": 16,
92          "tax_amount": 224
93        }
94      ]
95    }
96  ],
97  "totals": {
98    "net_amount": 1400,
99    "taxes_amount": 224,
100    "total_amount": 1624
101  }
102}

Invoice with exports complement

In order to create a new mexican invoice with international commerce complement, you need to use the /documents endpoint with the proper parameters.

1{
2  "header": {
3    "account_id": 141,
4    "document_type_id": "76",
5
6    "received_issued_flag": 1,
7    "issue_date": "2025-01-07",
8    "issuer_tax_id_code": "EKU9003173C9",
9    "issuer_tax_id_type": "MX-RFC",
10    "issuer_legal_name": "<string>",
11    "issuer_address": "<string>",
12    "issuer_district": "<string>",
13    "issuer_city": "<string>",
14    "issuer_country_id": "80",
15    "issuer_phone": "<string>",
16    "issuer_activity": "<string>",
17    "receiver_tax_id_code": "EKU9003173C9",
18    "receiver_tax_id_type": "MX-RFC",
19    "receiver_legal_name": "ESCUELA KEMPER URGATE",
20    "receiver_address": "<string>",
21    "receiver_district": "<string>",
22    "receiver_city": "<string>",
23    "receiver_country_id": "80",
24    "receiver_phone": "<string>",
25    "receiver_activity": "<string>",
26    "payment_conditions": "0",
27    "currency_id": 31,
28    "additional": {
29        "mx_exports": {
30            "terms": "FOB",
31            "exchange_rate": 20.6708,
32            "total": 1624,
33            "origin": {
34                "address_street": "CALLE DEL PAPEL",
35                "address_city_id": "01",
36                "address_county_id": "1961",
37                "address_state_id": "45",
38                "address_country_id": "80",
39                "address_postalcode": "76199"
40            },
41            "destination": {
42                "tax_id_type" : "US-EIN",
43                "tax_id_code": "222333444",
44                "address_street": "2470 SW 19th",
45                "address_state_id": "61",
46                "address_country_id": "89",
47                "address_postalcode": "00000"
48            },
49            "merchandise": {
50                "details": [
51                    {
52                        "customs_code": "2402200100",
53                        "customs_quantity" : "117.64",
54                        "sku" : "aa111",
55                        "customs_measure_unit": "01",
56                        "customs_unit_value": "13.81",
57                        "customs_total_value": "1624.00"
58                    }
59                ]
60            }
61        }
62
63      }
64  },
65
66  "details": [
67    {
68      "quantity": 1,
69      "sku": "aa111",
70      "line_description": "Prueba Koywe",
71      "unit_measure": "UN",
72      "unit_price": 1500,
73      "long_description": "Esta es una linea de prueba",
74      "modifier_amount": -100,
75      "total_taxes": 224,
76      "modifier_percentage": 0,
77      "total_amount_line": 1624,
78      "taxes": [
79        {
80          "tax_type_id": "362",
81          "tax_percentage": 16,
82          "tax_amount": 224
83        }
84      ]
85    }
86  ],
87  "totals": {
88    "net_amount": 1400,
89    "taxes_amount": 224,
90    "total_amount": 1624
91  }
92}
API Reference POST /documents

Detailed endpoint documentation