Exenciones fiscales

Si vende a revendedores, agencias gubernamentales u organizaciones sin fines de lucro, esos compradores tienen certificados de exención que los eximen del impuesto de venta en estados específicos. Zonos almacena esos certificados en un perfil de cliente para que un comprador exento pueda ser reconocido en el checkout.

Las exenciones se registran por jurisdicción. Un cliente exento en Carolina del Sur no está automáticamente exento en Texas, por lo que cada estado para el que el cliente tiene un certificado es un registro independiente con sus propias fechas y número de certificado.

Las exenciones se asocian a un cliente ya existente, por lo que la sincronización requiere dos llamadas: crear el cliente y luego sincronizar sus certificados. Ambas se identifican con su propio ID de cliente, el mismo customerId que utiliza en el resto de Checkout. Zonos nunca requiere que almacene un ID interno.

Esta función solo está disponible para integraciones de API personalizadas.

Crear o actualizar el cliente 

checkoutCustomerUpsert crea un perfil de cliente, o lo actualiza si ya existe uno para ese customerId. A diferencia de checkoutCustomerProfileAuthenticate, esto no requiere que el comprador esté presente, por lo que puede aprovisionar su lista de clientes con antelación. Consulte crear o actualizar un perfil sin un comprador para conocer el comportamiento completo de los campos.

Como coincide según customerId, invocarlo repetidamente actualiza el mismo perfil en lugar de crear duplicados. Es seguro ejecutarlo en toda su lista de clientes en cada sincronización.

Sincronizar exenciones fiscales 

checkoutCustomerTaxExemptionsSync acepta varios clientes a la vez. Cada entrada reemplaza el conjunto completo de exenciones de ese cliente.

Un expiresAt omitido significa que el certificado no caduca. Un exemptionReason omitido usa UNSPECIFIED de forma predeterminada.

Cómo funciona la sincronización 

Tres reglas rigen cada sincronización.

La lista es la fuente autorizada. taxExemptions es el conjunto completo del cliente, no una lista de cambios. Cualquier exención ya registrada que falte en la lista se elimina; así es como un certificado retirado deja de aplicarse. Enviar una lista parcial elimina silenciosamente todo lo que se omite.

Cada registro es una exención. No existe forma de registrar que un cliente no está exento en algún lugar; consulte la nota a continuación.

Eliminar todas las exenciones es una lista vacía. Para borrar los certificados de un cliente, envíelos con "taxExemptions": []. Omitir al cliente por completo en la carga útil deja intactos sus registros existentes.

Motivos de exención 

exemptionReason describe por qué el cliente está exento. Es opcional y usa UNSPECIFIED de forma predeterminada, pero indicarlo vale la pena; consulte a continuación.

Los motivos se dividen en dos grupos, y la diferencia importa. Los motivos basados en la entidad (gobierno, benéfico, religioso, educativo) eximen al comprador sin importar lo que compre. Los motivos basados en el uso, sobre todo RESALE, solo cubren bienes que califican: un certificado de reventa cubre el inventario que el comprador revenderá, no el mobiliario de oficina del mismo pedido.

Sin un motivo, Zonos no puede distinguir entre ambos casos y solo puede eximir pedidos completos, lo cual es más difícil de justificar para los certificados de reventa. Si la mayoría de sus exenciones son de reventa, enviar RESALE como valor predeterminado con las excepciones indicadas individualmente suele suponer mucho menos trabajo que clasificar a cada cliente.

Referencia de exención 

exemptionReference es el número impreso en la documentación de exención del cliente. Según el estado y el tipo de exención, puede ser un número de permiso de reventa o de vendedor, un número de certificado de exención estatal, un número de permiso de pago directo o un ID fiscal federal.

Es obligatorio en cada registro. Almacénelo y envíelo exactamente como aparece en el certificado; los formatos varían ampliamente según la jurisdicción (SR EAA 12-345678, 85-8012345678C-9, 12-3456789), y Zonos conserva el valor tal como se envió, salvo por eliminar los espacios en blanco circundantes. No cambie las mayúsculas ni elimine guiones ni espacios.

Registros rechazados 

Los registros se validan uno por uno. Un registro rechazado se reporta en rejected y no hace fallar el resto del lote, ni altera la exención ya registrada para esa jurisdicción.

Los clientes desconocidos se rechazan en lugar de crearse, de modo que un customerId mal escrito aparece en la respuesta en lugar de crear un perfil que nunca coincidirá con un comprador real.

Solo se validan las áreas administrativas de EE. UU. Las subdivisiones de otros países se aceptan tal como se envían.

Leer y eliminar 

Lea las exenciones de un cliente para confirmar que una sincronización se realizó correctamente:

Para eliminar todas las exenciones de un cliente, por ejemplo cuando cierra su cuenta, use checkoutCustomerTaxExemptionsDelete. Devuelve SUCCESS independientemente de si el cliente tenía exenciones o no, por lo que es seguro invocarlo más de una vez.