POST /invoices/create_full
Permite crear una factura con una nueva sucursal y un nuevo cliente

Permite crear una factura o un recibo de honorarios con la información enviada (Ver más abajo).

Formatos soportados

json

Errores

Code Description Metadata
401 Unauthorized 
:status: status
:message: error_message
422 Unprocessable Entity 
:status: status
:errors: []
500 Server crashed 
:status: status
:message: error_message

Ejemplos

    === Ejemplo de los parametros que se deben de enviar con la petición para crear una factura

{
	"invoice": {
		"issuer_rfc": "AAD990814BP7",
		"purpose_cfdi_id": 1,
		"serie": "A",
		"folio": "5",
		"date": "25-11-2017",
		"payment_form_ids": [1],
		"isr_retencion": "",
		"discount_amount": "",
		"money_id": 1,
		"branch_id": "",
		"invoice_type_id": 1,
		"discount_type_id": 1,
		"receipt_type_id": 1,
		"iva_retencion_type_id": "",
		"payment_method_id": 1,
		"paid_date": "",
		"branch_attributes": {
			"name": "Oficina Garcia Gineres 2",
			"serie": "G",
			"folio": "1",
			"address_attributes": {
				"id": "",
				"cp": "97070",
				"state_id": "2106",
				"full_address": "Av. Tres Marías Terrazas No. 240 Col. Tres Marías"
			}
		},
		"receptor_attributes": {
			"name": "Jose Gustavo",
			"social_reason": "Jose Gustavo Canul Poot",
			"rfc": "CAPG920428k1A",
			"email": "gus.knul@gmail.com",
			"issuer_id": "",
			"person_fiscal_type_id": 1,
			"type_receptor_id": 1
		},
		"concepts_attributes": [{
			"quantity": "1",
			"unit": "1",
			"description": "Tacos",
			"price": "10",
			"amount": "20",
			"iva_type_id": 1,
			"key_sat": "50192602",
			"iva": "",
			"iva_retencion": "",
			"isr_retencion": "",
			"iva_retencion_type_id": 1,
			"measure_unit_id": 2
		}]
	}
}

    === Respuesta del servidor cuando la factura se lográ timbrar, status: 201
{
  id: 17,
  invoice_status: "Timbrada",
  paid_status: "true",
  message: "La factura fue timbrada exitósamente"
  xml=>"xml string",
  pdf_file=>"pdf base 64"
}
    === Respuesta del servidor cuando la factura no se lográ timbrar, status: 201
{
  id: 16,
  invoice_status: "No timbrada",
  paid_status: "true",
  mensaje: "Se creó la factura exitosamente pero no se logró timbrar",
  error: "Ocurrió un problema, intente nuevamente en unos minutos. Contacte al administrador si persiste el problema"
}

Parámetros

Nombre del parámetro Descripción
invoice_status
requerido

Estatus de la factura

Validations:

  • Must be one of: Timbrada, No timbrada, Cancelada.
paid_status
requerido

Índica si la factura esta cobrada o no

Validations:

  • Must be one of: true, false.
name
requerido

Nombre del objeto (Cliente, Sucursal, Empresa)

Validations:

  • Must be String
address_attributes
opcional

Objeto que representa la direccion de una Sucursal)

Validations:

  • Must be Object
serie
requerido

Letra de serie para las facturas o las sucursales

Validations:

  • Must be String
folio
requerido

Número de folio para las facturas o las sucursales

Validations:

  • Must be a number.
date
requerido

Fecha y hora de creación de la factura

Validations:

  • Must be String
payment_form
requerido

Forma de pago de la factura

Validations:

  • Must be one of: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11.


Metadata: 
1: Efectivo
2: Cheque nominativo
3: Transferencia electrónica de fondos
4: Tarjeta de crédito
5: Monedero electrónico
6: Dinero electrónico
7: Vales de despensa
8: Tarjeta de débito
9: Tarjeta de servicio
10: Otros
num_account
opcional

Número de cuenta para el deposito

Validations:

  • Must be String
payment_conditions
opcional

Condiciones para efectuar el pago

Validations:

  • Must be String
note
opcional

Alguna nota adicional que puede tener la factura

Validations:

  • Must be String
discount_amount
opcional

Cantidad de descuento

Validations:

  • Must be a number.
issuer_rfc
requerido

RFC de la empresa que emite la factura

Validations:

  • Must be a number.
branch_name
requerido

Nombre de la sucursal donde se emite la factura

Validations:

  • Must be a number.
receptor_rfc
requerido

RFC del cliente que recibe la factura

Validations:

  • Must be a number.
money_id
requerido

id del tipo de moneda que maneja la factura

Validations:

  • Must be one of: 1, 2.


Metadata: 
1: MXN
2: USD
discount_type_id
requerido

id del tipo de descuento que maneja la factura

Validations:

  • Must be one of: 1, 2, 3.


Metadata: 
1: Ninguno
2: Precio
3: Porcentaje
receipt_type_id
requerido

id del tipo de

Validations:

  • Must be one of: 1, 2, 3, 4, 5.


Metadata: 
1: Ingreso
2: Egreso
3: Traslado
4: Nomina
5: Pago
payment_method_id
requerido

id de los métodos de pago de la factura. Para más información ver el siguierte enlace www.sat.gob.mx/fichas_tematicas/buzon_tributario/Documents/catalogo_metodos_pago.pdf

Validations:

  • Must be one of: 1, 2.


Metadata: 
1: Pago en una sola exhibición
2: Pago en parcialidades o diferido
invoice_type_id
requerido

id del tipo de factura

Validations:

  • Must be one of: 1, 2, 3.


Metadata: 
1: Factura
2: Recibo de Honorarios
3: No aplica
purpose_cfdi_id
requerido

Uso del CFDI(Consultar Servicio purpose_cfdis)

Validations:

  • Must be Integer
branch_id
requerido

ID de sello digital de la empresa que emite la factura

Validations:

  • Must be Integer
key_sat
requerido

CLave de producto del SAT

Validations:

  • Must be String
measure_unit_id
requerido

Unidad de medida para el concepto

Validations:

  • Must be String
iva_retencion_type_id
opcional

id del tipo de retencion que se le va aplicar al recibo de honorario

Validations:

  • Must be one of: 1, 2.


Metadata: 
1: 2/3
2: 4%
concepts_attributes
requerido

Hash de objetos que representan los conceptos de las factura, con índices para cada objeto concepto

Validations:

  • Must be Hash
quantity
requerido

Cantidad del concepto

Validations:

  • Must be String
unit
requerido

Unidad del concepto

Validations:

  • Must be String
description
requerido

Descripción del concepto

Validations:

  • Must be String
price
requerido

Precio del concepto

Validations:

  • Must be String
iva_type_id
requerido

id del tipo de IVA aplicada al concepto

Validations:

  • Must be one of: 1, 2, 3.


Metadata: 
1: Tasa del 16%
2: Tasa Cero
3: Exento de IVA
social_reason
requerido

Razón social del cliente

Validations:

  • Must be String
rfc
requerido

RFC del cliente

Validations:

  • Must be String
email
requerido

Correo del cliente

Validations:

  • Must be String
phone
requerido

Teléfono de la sucursal

Validations:

  • Must be String
street
requerido

Calle(s) de la direción

Validations:

  • Must be String
num_internal
requerido

Número interior de la direción

Validations:

  • Must be String
num_outside
opcional

Número exterior de la direción

Validations:

  • Must be String
colony
requerido

Colonia de la direción

Validations:

  • Must be String
location
requerido

Localidad de la direción

Validations:

  • Must be String
municipality
requerido

Municipio de la direción

Validations:

  • Must be String
reference
requerido

Referencia de la dirección

Validations:

  • Must be String
state_id
requerido

id del estado de la dirección

Validations:

  • Must be String
cp
opcional

04930

Validations:

  • Must be String