La LCO fue actualizada por última vez el 31/mar/2025
Method: cancelar
(cancel)A new process for canceling invoices will come into effect on September 1 2018, for more information on this see page: Cancelación CFDI 3.3
The Webservice CFDI33 cancelar cancels one or several Invoices.
-
A field is required if thus stated in column "Required":
- Yes: this field is required.
- No: this field is not mandatory.
- Conditional: this field may be required or not, depending on other fields.
- Parameters:
-
Name Description Required usuario xs:string
Registered username.
Yes password xs:string
User's password.
Yes solicitudesCancelacion Compound type solicitudesCancelacion
Searching criteria for the invoice to be canceled.
Yes
solicitudesCancelacion's fields- Search criteria may be:
- UUID only or
- Commercial folio and serie
Name Description Required folio xs:long
The commercial number of this invoice.
Conditional serie xs:string
The serie fo this invoice.
Conditional uuid xs:string
The fiscal identifier of this invoice.
Conditional motivoCancelacion xs:string
Reason of cancellation.
No
Request example
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | <?xml version="1.0" encoding="UTF-8"?><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:fac="http://facturacion.erp.solucionfactible.com"> <soapenv:Header/> <soapenv:Body> <fac:cancelar> <usuario>demo@empresa.com.mx</usuario> <password>empresa</password> <solicitudesCancelacion> <folio>778</folio> <serie>BZ</serie> </solicitudesCancelacion> <motivoCancelacion>Prueba de cancelación</motivoCancelacion> </fac:cancelar> </soapenv:Body> </soapenv:Envelope> |
Returns
- The method returns a compound type: RespuestaCancelacion, whose fields are described in the following table.
-
RespuestaCancelacion's fields
ResultadoCancelacion's fieldsName Description Required status xs:int
Operation-status code, for more detail check the table Operation's status codes.
Yes mensaje xs:string
Detailed message of the operation's success/error.
Yes resultadosCancelacion Compound type ResultadoCancelacion
Compound type, one for each canceled invoice's result.
Yes acuseSAT xs:string
SAT's cancellation acknowledgement in 64base encoding.
Yes Name Description Required detalle xs:string
Message detailing the current status of the invoice. ("Canceled", "This invoice had already been canceled", etc).
Yes estatusUUID xs:string
Invoice's current status code
Conditional folio xs:long
Canceled invoice commercial folio
Conditional serie xs:string
Canceled invoice series
Conditional uuid xs:string
Canceled invoice fiscal folio
Conditional
Response example
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | <soap:Body> <return> <estatus>201</estatus> <mensaje>El CFDI con folio fiscal FF5E104F-41A0-4921-B9AD-D47FBB6CC6F5 se ha cancelado.</mensaje> <resultados> <detalle>Cancelada</detalle> <estatusUUID>201</estatusUUID> <folio>10991300001</folio> <serie>PI</serie> <uuid>FF5E104F-41A0-4921-B9AD-D47FBB6CC6F5</uuid> </resultados> <acuseSAT>PHM6RW52ZWxvcGUgeG1sbnM6cz0iaHR0cDovL3NjaGVtYXMueG1sc29hcC5vcmcvc29hcC9lbnZlbG9wZS8iPjxzOkJvZHkgeG1sbnM6eHNpPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYS1pbnN0YW5jZSIgeG1sbnM6eHNkPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxL1hNTFNjaGVtYSI+PENhbmNlbGFDRkRSZXNwb25zZSB4bWxucz0iaHR0cDovL2NhbmNlbGFjZmQuc2F0LmdvYi5teCI+PENhbmNlbGFDRkRSZXN1bHQgRmVjaGE9IjIwMTgtMTAtMzBUMDk6MDc6MTcuNTc1IiBSZmNFbWlzb3I9IkxQSTgzMDUyN0tKMiI+PEZvbGlvcz48VVVJRD5GRjVFMTA0Ri00MUEwLTQ5MjEtQjlBRC1ENDdGQkI2Q0M2RjU8L1VVSUQ+PEVzdGF0dXNVVUlEPjIwMTwvRXN0YXR1c1VVSUQ+PC9Gb2xpb3M+PFNpZ25hdHVyZSBJZD0iU2VsbG9TQVQiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcjIj48U2lnbmVkSW5mbz48Q2Fub25pY2FsaXphdGlvbk1ldGhvZCBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnL1RSLzIwMDEvUkVDLXhtbC1jMTRuLTIwMDEwMzE1Ii8+PFNpZ25hdHVyZU1ldGhvZCBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnLzIwMDEvMDQveG1sZHNpZy1tb3JlI2htYWMtc2hhNTEyIi8+PFJlZmVyZW5jZSBVUkk9IiI+PFRyYW5zZm9ybXM+PFRyYW5zZm9ybSBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnL1RSLzE5OTkvUkVDLXhwYXRoLTE5OTkxMTE2Ij48WFBhdGg+bm90KGFuY2VzdG9yLW9yLXNlbGY6OipbbG9jYWwtbmFtZSgpPSdTaWduYXR1cmUnXSk8L1hQYXRoPjwvVHJhbnNmb3JtPjwvVHJhbnNmb3Jtcz48RGlnZXN0TWV0aG9kIEFsZ29yaXRobT0iaHR0cDovL3d3dy53My5vcmcvMjAwMS8wNC94bWxlbmMjc2hhNTEyIi8+PERpZ2VzdFZhbHVlPncxeG1zaGx4bGdZeWtybVJCZTJLU2sxMGxxbz08L0RpZ2VzdFZhbHVlPjwvUmVmZXJlbmNlPjwvU2lnbmVkSW5mbz48U2lnbmF0dXJlVmFsdWU+MW1kQnFDNUJCcGovOWJnQVZydEk1NUo5R3B0ckNaOEthZWp6YmhoYyszWEtWT1dYMEV5dDFlTVVlbjlpcW4yZjhWRXdsa1JrTDJ0aGsrYWRIYU1NV210WDIxR2FvWmNXOExra2w1ZVd4OG1wcDlRMEY0ckc5K2VlUGJDcVVCdTVkVlQ1R3pHMUQvUmJDai82SFIvMS9ZN1B2T0daVStmcjE0b2JCRWxhdGJaM2NHQm5lNkl5d1V5aEtnMy9VeThQaXdPOVdBVFBGUWxHT092cHFkQitXbFcyTGR3a0RyNjRZTm9aQ0s5dVdaQWU5VXdabGV4T3ovcGJUem9ib0FRV3hnMHBJeHNiQmt3bzdIUDFmeHAvZ3Rlcm41WU1PeG1IN2NDZGJoYmg5anpXZ2V5d0VtOEY2cWpTc2Ywb1RaTkszYk5vNWkrMFFMSE9XcEJ6czdnczN3PT08L1NpZ25hdHVyZVZhbHVlPjxLZXlJbmZvPjxLZXlOYW1lPjAwMDAwMDAwMDAwMDAwMDAwMDAwPC9LZXlOYW1lPjxLZXlWYWx1ZT48UlNBS2V5VmFsdWU+PE1vZHVsdXM+eXhNdlV1Y3VTK3MzYWVXVEZadkpyckZXSWRlczdrSURKbU83REE1RFArWlRhcG9mTnQzN2ZnZUlIbFRVZEFWdmQvZkRLaGZpd05TaCt2YnJOYkQ1OFgzVUVkUW9yM25nYjZ6cGpyRGpnWXNlZGNrUEx2NmZybzRETzBOWExDZEFMRnFoTjhBUnlYNzdrWUJudklqMWZPU1ZwNDAxVmMzdXJMVXRpRW0xNktsZTN0T3lXaGZqZ0Z6ZEszb0FJWEY4b2VlaS9HYnVyV2JKbnBQK05lR2FIVkU1Ymt4TENCcDU3NTduS1Zvblh3enBmcEVHdUJwMjA0TkdrSTIvanlBMkVIOHd5Uk40eVV2empUN0lKWXJIbmcyM2tsUkRsSm9SWXdhOThRUVBkUVNUcGNybE51OG5MaHBRZEkvek1UTG9ORjJOaUJDa1FOdUFNYWNLaG52bFZ3PT08L01vZHVsdXM+PEV4cG9uZW50PkFRQUI8L0V4cG9uZW50PjwvUlNBS2V5VmFsdWU+PC9LZXlWYWx1ZT48L0tleUluZm8+PC9TaWduYXR1cmU+PC9DYW5jZWxhQ0ZEUmVzdWx0PjwvQ2FuY2VsYUNGRFJlc3BvbnNlPjwvczpCb2R5PjwvczpFbnZlbG9wZT4=</acuseSAT> </return> </ns2:cancelarResponse> </soap:Body></soap:Envelope> |
Response example of a cancelation attempt of an already canceled invoice
| Name | Description | Required |
| estatus | xs:string Operation-status code. |
Yes |
| mensaje | xs:string Detailed message of the operation's success/error. |
Yes |
1 2 3 4 5 6 7 8 9 10 | <soap:Body> <return> <estatus>202</estatus> <mensaje>Ya se había cancelado el comprobante</mensaje> </return> </ns2:cancelarResponse> </soap:Body></soap:Envelope> |
Response example of an invoice which CANNOT be canceled
| Name | Description | Required |
| estatus | xs:string Operation-status code. |
Yes |
| mensaje | xs:string Detailed message of the operation's success/error. |
Yes |
1 2 3 4 5 6 7 8 9 10 | <soap:Body> <return> <estatus>204</estatus> <mensaje>El servicio de consulta del SAT indica el CFDI con folio fiscal 34527C28-E112-485B-8D48-7A76B836E5C9 no es cancelable.</mensaje> </return> </ns2:cancelarResponse> </soap:Body> </soap:Envelope> |
Response example for an invoice that requires authorization
| Name | Description | Required |
| estatus | xs:string Operation-status code. |
Yes |
| mensaje | xs:string Detailed message of the operation's success/error. |
Yes |
1 2 3 4 5 6 7 8 9 10 | <soap:Body> <return> <estatus>211</estatus> <mensaje>La cancelación del CFDI con folio fiscal F0D5F3E5-1EDC-4BAA-BECD-427BA1FD592B requiere autorización por parte del receptor.</mensaje> </return> </ns2:cancelarResponse> </soap:Body> </soap:Envelope> |
Respones example - Retry of cancelation attempt for an invoce that requires authorization
| Name | Description | Required |
| estatus | xs:string Operation-status code. |
Yes |
| mensaje | xs:string Detailed message of the operation's success/error. |
Yes |
1 2 3 4 5 6 7 8 9 10 | <soap:Body> <return> <estatus>211</estatus> <mensaje>El CFDI con folio fiscal F0D5F3E5-1EDC-4BAA-BECD-427BA1FD592B sigue en proceso de aceptación.</mensaje> </return> </ns2:cancelarResponse> </soap:Body> </soap:Envelope> |
Ejemplo de respuesta Comprobante aún no entregado al SAT
| Name | Description | Required |
| estatus | xs:string Operation-status code. |
Yes |
| mensaje | xs:string Detailed message of the operation's success/error. |
Yes |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | <soap:Body> <return> <estatus>201</estatus> <mensaje>El servicio de consulta del SAT indica el CFDI con folio fiscal 8EB30656-ED34-4701-BAFF-2DA8932362B6 no existe.</mensaje> <resultados> <detalle>No se ha podido cancelar este comprobante. El SAT ha respondido con un status de error: [205] El SAT no ha procesado la recepción de este comprobante por lo cual no puede ser cancelado, por favor espere al menos 24 horas después de la generación del mismo y vuelva a intentar cancelarlo.</detalle> <estatusUUID>205</estatusUUID> <uuid>8EB30656-ED34-4701-BAFF-2DA8932362B6</uuid> </resultados> </return> </ns2:cancelarResponse> </soap:Body> </soap:Envelope> |
-
Operation's status codes
More detailed descriptions may appear in mensaje field
- 200 — Process successful.
- 500 — The process could not be finished due to errors. Please retry.
- 501 — Failed attempting to connect to Database. Please retry.
- 502 — Failed attempting to store or retrieve data from Database.
- 503 — The maximum number of concurrent Database access attempts has been reached.
- 601 — Authentication error, please verify your credentials.
- 602 — This account is blocked.
- 603 — The account's password has expired.
- 604 — The maximum number of retry attempts due to failed authentication has been reached. The account will be blocked.
- 610 — The requested action is not supported in you implementation because either the implementation is not yet configured for such an action or is not possible its accomplishment. For the importar method this means your implementation has no connector configured yet.
- 611 — One or several required fields are missing in the request.
- 612 — Malformed file. The file format is different to the one expected.
- 613 — The numeric sequence has reached the end.
- 620 — You do not have permission to do this action.
- 621 — Invalid field.
- 622 — Unsupported action.
- 623 — Data not found.
- 624 — Uniqueness restriction violation.
- 625 — This action cannot be completed because it requires a previous action to complete.
- 626 — Implementation's configuration error.
- 630 — Your implementation's contract has expired.
- 631 — Your contract's payment date has passed.
- 632 — The maximum number of usage attempts for this implementation has been reached.
- 633 — This implementation is inactive.
3.3 cancelation's additional status codes
- 201 - Could not cancel the invoice. SAT has responded with error code: [205]
- 202 - The invoice had already been canceled
- 204 - The invoice cannot be canceled
- 211 - The cancelation is still in process
- 213 - The cancelation request was denied by the invoice's receiver
| UUIDs that can be used in the testing environment that return this status code |
| E329DD15-7D0B-44E9-A204-51A7443D1FBE |
| 5B4B180D-5B6C-4392-B204-252215A1AB84 |
| 51D8A114-2BA6-40B8-C204-B9721791863B |
| 1BCA95C3-DA01-44C2-D204-59A9114F94BE |
| F4621025-0864-4E62-E204-59EE41B1101E |
| UUIDs that can be used in the testing environment that return this status code |
| C5E58106-6C1E-41C9-A211-FB8BAD1CABB0 |
| 38FB9AC9-DD3E-4601-B211-EB02C007C3BA |
| CB917CA9-60D3-4A81-C211-76BD1A6B756D |
| 7C34D543-E6C9-4990-D211-3F767E0B5142 |
| 0D62B12C-BC6C-4626-E211-FC8FE727A5BC |
