TRtrytoku
Facturación

Crear datos de facturación de Customer

Changed on

Registra los datos de facturación de un Customer.

Se usa para dar de alta la información fiscal con la que se emitirán sus billing documents. Devuelve los datos creados. Falla con 400 si la checkout session referenciada no existe.

post/customer-billing-data

Request

  • Base URL
    https://api.trytoku.com
  • URL
    https://api.trytoku.com/customer-billing-data
  • Auth
    API key in header x-api-key

Headers

x-account-keystring

Llave de API de una Account, para operar sobre esa Account en lugar de la principal.

Request body

billing_addressstring

Domicilio fiscal. Informativo: no viaja al SAT, se guarda para tus propios registros.

billing_emailstring

Correo al que se envía el CFDI cuando la emisión incluye envío por correo.

checkout_session_idstring

Identificador de la Checkout Session, para registrar los datos cuando el Customer todavía no existe. Alternativa a id_customer.

id_customerstring

Identificador público del Customer. Se envía este o checkout_session_id, al menos uno de los dos.

legal_namestring required

Razón social del Customer tal como está registrada ante el SAT.

tax_idstring required

RFC del Customer. Es el receptor del CFDI, así que el SAT rechaza la emisión si no coincide con un contribuyente registrado.

tax_regimestring required

Clave del régimen fiscal del Customer según el catálogo del SAT, de tres dígitos. Debe ser uno de los permitidos para su tipo de persona.

tax_zip_codestring required

Código postal del domicilio fiscal registrado ante el SAT. Tiene que coincidir con el que el SAT tiene para ese RFC; si no, rechaza el CFDI.

Example request

{
  "billing_address": "Av. Insurgentes Sur 1234, Col. Del Valle",
  "billing_email": "facturacion@empresademo.mx",
  "checkout_session_id": "cs_7Hn2kLm0QpXr7Zt3Wv1Nb8Yc4Ad6Ge5J",
  "id_customer": "cus_fLPjkiFoTCpGKFUIA52AqiOg8B4OdIWO",
  "legal_name": "EMPRESA DEMO SA DE CV",
  "tax_id": "GODE561231GR8",
  "tax_regime": "601",
  "tax_zip_code": "03100"
}

Response

Successful Response

billing_addressstring

Domicilio fiscal. Informativo: no viaja al SAT, se guarda para tus propios registros.

billing_emailstring

Correo al que se envía el CFDI cuando la emisión incluye envío por correo.

checkout_session_idstring
id_customerstring
legal_namestring required

Razón social del Customer tal como está registrada ante el SAT.

tax_idstring required

RFC del Customer. Es el receptor del CFDI, así que el SAT rechaza la emisión si no coincide con un contribuyente registrado.

tax_regimestring required

Clave del régimen fiscal del Customer según el catálogo del SAT, de tres dígitos. Debe ser uno de los permitidos para su tipo de persona.

tax_zip_codestring required

Código postal del domicilio fiscal registrado ante el SAT. Tiene que coincidir con el que el SAT tiene para ese RFC; si no, rechaza el CFDI.

Example response

{
  "billing_address": "Av. Insurgentes Sur 1234, Col. Del Valle",
  "billing_email": "facturacion@empresademo.mx",
  "legal_name": "EMPRESA DEMO SA DE CV",
  "tax_id": "GODE561231GR8",
  "tax_regime": "601",
  "tax_zip_code": "03100"
}

Changes

  • a6ef070075b1Revision changes
    • breaking

      request body became required

    • breaking

      removed the success response with the status

    • info

      api operation id crear-información-de-facturación-del-customer removed and replaced with create_customer_billing_data

    • info

      api tag Facturación added

    • info

      added the new optional header request parameter x-account-key

    • info

      added the new optional request property

    • info

      the request property became optional

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      removed the non-success response with the status

    • info

      added the success response with the status