{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/es/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Errores","description":"Documentação oficial, guias e referência da API Auvo v2.","siteUrl":"https://developers.auvo.com.br","lang":"pt-BR","keywords":"auvo, api, documentação, developers, field service, workforce","meta":[{"name":"og:site_name","content":"Auvo Developers"},{"name":"og:locale","content":"pt_BR"},{"name":"og:locale:alternate","content":"es_ES"},{"name":"og:locale:alternate","content":"en_US"},{"name":"twitter:card","content":"summary_large_image"},{"name":"twitter:site","content":"@auvoapp"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"errores","__idx":0},"children":["Errores"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["La API Auvo usa códigos HTTP estándar y devuelve ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{ \"error\": \"<mensaje>\" }"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"mapa-rápido","__idx":1},"children":["Mapa rápido"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Código"},"children":["Código"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Significado"},"children":["Significado"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Acción"},"children":["Acción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payload inválido"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Revisa schema/tipos antes de reenviar."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Token ausente/expirado"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Renueva con ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /login"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Límite de tasa excedido"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Aplica backoff exponencial."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recurso inexistente"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verifica ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},"/slug."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["409"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conflicto (p. ej., duplicidad)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Consulta el estado remoto antes."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["415"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Falta ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Content-Type"]}," en POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Enviar ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/json"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["422"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validación semántica"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lee ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error"]}," y corrige."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["429"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Límite de tasa (reserva futura)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Trátalo como 403."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["500"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fallo interno"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reporta a help@auvo.com.br con ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deliveryId"]},"/timestamp."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"envelope","__idx":2},"children":["Envelope"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{ \"error\": \"The field 'email' is not a valid email address\" }\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"estrategia-de-retry","__idx":3},"children":["Estrategia de retry"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Idempotentes (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE"]},")"]},": retry con backoff en 5xx y 403."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["No idempotentes (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH"]},")"]},": evita retry ciego — usa correlación"," ","(p. ej. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["externalId"]},") para detectar duplicados antes de reenviar."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting","__idx":4},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Guarda ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Request-Id"]}," (cuando esté presente) en los logs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reproduce en curl antes de reportar — elimina variables del cliente HTTP."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Si es posible, adjunta el payload redactado al abrir el ticket."]}]}]},"headings":[{"value":"Errores","id":"errores","depth":1},{"value":"Mapa rápido","id":"mapa-rápido","depth":2},{"value":"Envelope","id":"envelope","depth":2},{"value":"Estrategia de retry","id":"estrategia-de-retry","depth":2},{"value":"Troubleshooting","id":"troubleshooting","depth":2}],"frontmatter":{"title":"Errores","description":"Códigos HTTP, payload de error y troubleshooting.","seo":{"title":"Errores"}},"lastModified":"2026-04-24T13:01:34.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/es/guides/errors","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}