Crear un borrador
POST
/invoice-drafts
FACTUCAT_API_URL="${FACTUCAT_API_URL:-https://sandbox.factucat.com/api/v1}"
curl --fail-with-body --request POST \ --url "$FACTUCAT_API_URL/invoice-drafts" \ --header "X-API-Key: $FACTUCAT_API_KEY" \ --header 'Content-Type: application/json' \ --data '{}'const baseUrl = process.env.FACTUCAT_API_URL || "https://sandbox.factucat.com/api/v1"const body = JSON.stringify({})const response = await fetch(`${baseUrl}/invoice-drafts`, { method: "POST", headers: { 'X-API-Key': process.env.FACTUCAT_API_KEY, 'Content-Type': 'application/json', }, body,})const text = await response.text()if (!response.ok) throw new Error(`HTTP ${response.status}: ${text}`)console.log(JSON.parse(text))import jsonimport osimport urllib.errorimport urllib.request
base_url = os.environ.get("FACTUCAT_API_URL", "https://sandbox.factucat.com/api/v1")body = "{}".encode("utf-8")request = urllib.request.Request( f"{base_url}/invoice-drafts", method="POST", headers={ "X-API-Key": os.environ["FACTUCAT_API_KEY"], "Content-Type": "application/json", }, data=body,)try: with urllib.request.urlopen(request) as response: text = response.read().decode("utf-8")except urllib.error.HTTPError as error: raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8')}") from errorprint(json.loads(text))package main
import ( "bytes" "fmt" "io" "net/http" "os")
func main() { baseURL := os.Getenv("FACTUCAT_API_URL") if baseURL == "" { baseURL = "https://sandbox.factucat.com/api/v1" } body := []byte("{}") request, err := http.NewRequest("POST", baseURL + "/invoice-drafts", bytes.NewReader(body)) if err != nil { panic(err) } request.Header.Set("X-API-Key", os.Getenv("FACTUCAT_API_KEY")) request.Header.Set("Content-Type", "application/json") response, err := http.DefaultClient.Do(request) if err != nil { panic(err) } defer response.Body.Close() text, _ := io.ReadAll(response.Body) if response.StatusCode < 200 || response.StatusCode >= 300 { panic(fmt.Sprintf("HTTP %d: %s", response.StatusCode, text)) } fmt.Print(string(text))}Authorizations
Sección titulada «Authorizations»Parameters
Sección titulada «Parameters»Header Parameters
Sección titulada «Header Parameters»Idempotency-Key
string
Opcional. Reutiliza la misma clave, ruta y contenido para reintentar una operación sin repetirla. Una clave con contenido diferente devuelve 409. Sin clave, cada solicitud es independiente.
Request Body
Sección titulada «Request Body»Media typeapplication/json
object
issueDate
Fecha de emisión: YYYY-MM-DD o datetime ISO (día en la zona horaria del código postal de expedición). La fecha de emisión puede ser hoy o hasta 72 horas antes del timbrado (máximo 3 días de calendario atrás), nunca futura, en la zona horaria del código postal de expedición (regla 2.7.2.9 RMF). INVALID_ISSUE_DATE si no es válida.
string
customerId
string format: uuid
receiverRfc
string
receiverLegalName
string
receiverFiscalResidence
string
receiverTaxId
string
receiverEmail
string format: email
receiverInvoiceLanguage
string
currency
string
exchangeRate
number
exchangeRateDate
string format: date-time
cfdiUse
string
exportacion
string
Responses
Sección titulada «Responses»Operación exitosa
Media typeapplication/json
object
data
required
object
id
required
string format: uuid
userId
required
string
customerId
string format: uuid
receiverRfc
required
string
receiverLegalName
required
string
receiverPostalCode
required
string
receiverTaxRegime
required
string
receiverFiscalResidence
string
receiverTaxId
string
receiverEmail
string format: email
receiverInvoiceLanguage
required
string
serie
string
folio
string
satUuid
string
status
required
string
cfdiType
required
string
cfdiUse
required
string
exportacion
required
string
paymentMethod
string
paymentForm
string
currency
required
string
exchangeRate
required
number
exchangeRateDate
string format: date-time
subtotal
required
number
taxTotal
required
number
total
required
number
customerNotes
string
pdfLanguage
required
string
errorMessage
string
issueDate
Fecha de emisión seleccionada, en formato ISO 8601.
string format: date-time
issuedAt
string format: date-time
cancelledAt
string format: date-time
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
items
required
Array<object>
object
id
required
string format: uuid
invoiceId
required
string format: uuid
position
required
integer
productCode
string
unitCode
required
string
description
required
string
quantity
required
number
unitPrice
required
number
amount
required
number
objetoImp
string
vatKind
string
vatTreatment
string
vatSource
string
vatReason
string
isrWithholdingSource
string
isrWithholdingReason
string
suggestedProductCode
string
suggestionConfidence
number
suggestionSource
string
meta
required
object
requestId
required
string
idempotencyKey
string
pagination
object
limit
required
integer
offset
required
integer
hasMore
required
boolean
nextCursor
string | null
Datos inválidos
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
requestId
required
string
retryable
required
boolean
reason
string
API key ausente, inválida o de otro ambiente
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
requestId
required
string
retryable
required
boolean
reason
string
Plan inactivo o permisos insuficientes
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
requestId
required
string
retryable
required
boolean
reason
string
Recurso no encontrado
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
requestId
required
string
retryable
required
boolean
reason
string
Método no permitido
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
requestId
required
string
retryable
required
boolean
reason
string
Conflicto o solicitud en curso. error.reason es opcional; duplicate_rfc indica que ya existe un cliente con ese RFC en la cuenta; stamp_in_progress indica que el documento se está timbrando: consúltalo antes de reintentar.
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
requestId
required
string
retryable
required
boolean
reason
string
Límite de solicitudes alcanzado
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
requestId
required
string
retryable
required
boolean
reason
string
Headers
Sección titulada «Headers»Retry-After
integer
Segundos antes de reintentar.
Error interno
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
requestId
required
string
retryable
required
boolean
reason
string
PAC temporalmente no disponible
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
requestId
required
string
retryable
required
boolean
reason
string