> For the complete documentation index, see [llms.txt](https://wikiedoc.guru-soft.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wikiedoc.guru-soft.com/pe/integraciones-y-servicios/soap/ejemplos/nota-de-credito.md).

# Nota de Crédito

{% tabs %}
{% tab title="Request" %}

```xml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:emis="https://pe.edocnube.com/api/emision" xmlns:not="https://pe.edocnube.com/api/emision/notaCredito" xmlns:cred="https://pe.edocnube.com/api/emision/ubl/creditNote" xmlns:cred1="https://pe.edocnube.com/api/emision/ubl/creditNote.note" xmlns:cred2="https://pe.edocnube.com/api/emision/ubl/creditNote.discrepancyResponse" xmlns:cred3="https://pe.edocnube.com/api/emision/ubl/creditNote.discrepancyResponse.description" xmlns:cred4="https://pe.edocnube.com/api/emision/ubl/creditNote.billingReference" xmlns:cred5="https://pe.edocnube.com/api/emision/ubl/creditNote.billingReference.invoiceDocumentReference" xmlns:cred6="https://pe.edocnube.com/api/emision/ubl/creditNote.despatchDocumentReference" xmlns:cred7="https://pe.edocnube.com/api/emision/ubl/creditNote.additionalDocumentReference" xmlns:cred8="https://pe.edocnube.com/api/emision/ubl/creditNote.accountingSupplierParty" xmlns:cred9="https://pe.edocnube.com/api/emision/ubl/creditNote.accountingSupplierParty.party" xmlns:cred10="https://pe.edocnube.com/api/emision/ubl/creditNote.accountingSupplierParty.party.partyIdentification" xmlns:cred11="https://pe.edocnube.com/api/emision/ubl/creditNote.accountingSupplierParty.party.partyIdentification.iD" xmlns:cred12="https://pe.edocnube.com/api/emision/ubl/creditNote.accountingSupplierParty.party.partyName" xmlns:cred13="https://pe.edocnube.com/api/emision/ubl/creditNote.accountingSupplierParty.party.partyLegalEntity" xmlns:cred14="https://pe.edocnube.com/api/emision/ubl/creditNote.accountingSupplierParty.party.partyLegalEntity.registrationAddress" xmlns:cred15="https://pe.edocnube.com/api/emision/ubl/creditNote.accountingSupplierParty.party.partyLegalEntity.registrationAddress.addressLine" xmlns:cred16="https://pe.edocnube.com/api/emision/ubl/creditNote.accountingSupplierParty.party.partyLegalEntity.registrationAddress.country" xmlns:cred17="https://pe.edocnube.com/api/emision/ubl/creditNote.accountingCustomerParty" xmlns:cred18="https://pe.edocnube.com/api/emision/ubl/creditNote.accountingCustomerParty.party" xmlns:cred19="https://pe.edocnube.com/api/emision/ubl/creditNote.accountingCustomerParty.party.partyIdentification" xmlns:cred20="https://pe.edocnube.com/api/emision/ubl/creditNote.accountingCustomerParty.party.partyIdentification.iD" xmlns:cred21="https://pe.edocnube.com/api/emision/ubl/creditNote.accountingCustomerParty.party.partyLegalEntity" xmlns:cred22="https://pe.edocnube.com/api/emision/ubl/creditNote.accountingCustomerParty.party.partyLegalEntity.shareholderParty" xmlns:cred23="https://pe.edocnube.com/api/emision/ubl/creditNote.accountingCustomerParty.party.partyLegalEntity.shareholderParty.party" xmlns:cred24="https://pe.edocnube.com/api/emision/ubl/creditNote.accountingCustomerParty.party.partyLegalEntity.shareholderParty.party.partyIdentification" xmlns:cred25="https://pe.edocnube.com/api/emision/ubl/creditNote.accountingCustomerParty.party.partyLegalEntity.shareholderParty.party.partyIdentification.iD" xmlns:cred26="https://pe.edocnube.com/api/emision/ubl/creditNote.accountingCustomerParty.party.partyLegalEntity.shareholderParty.party.partyLegalEntity" xmlns:cred27="https://pe.edocnube.com/api/emision/ubl/creditNote.paymentTerm" xmlns:cred28="https://pe.edocnube.com/api/emision/ubl/creditNote.paymentTerm.amount" xmlns:cred29="https://pe.edocnube.com/api/emision/ubl/creditNote.taxTotal" xmlns:cred30="https://pe.edocnube.com/api/emision/ubl/creditNote.taxTotal.taxAmount" xmlns:cred31="https://pe.edocnube.com/api/emision/ubl/creditNote.taxTotal.taxSubtotal" xmlns:cred32="https://pe.edocnube.com/api/emision/ubl/creditNote.taxTotal.taxSubtotal.taxableAmount" xmlns:cred33="https://pe.edocnube.com/api/emision/ubl/creditNote.taxTotal.taxSubtotal.taxAmount" xmlns:cred34="https://pe.edocnube.com/api/emision/ubl/creditNote.taxTotal.taxSubtotal.taxCategory" xmlns:cred35="https://pe.edocnube.com/api/emision/ubl/creditNote.taxTotal.taxSubtotal.taxCategory.taxScheme" xmlns:cred36="https://pe.edocnube.com/api/emision/ubl/creditNote.legalMonetaryTotal" xmlns:cred37="https://pe.edocnube.com/api/emision/ubl/creditNote.legalMonetaryTotal.chargeTotalAmount" xmlns:cred38="https://pe.edocnube.com/api/emision/ubl/creditNote.legalMonetaryTotal.payableRoundingAmount" xmlns:cred39="https://pe.edocnube.com/api/emision/ubl/creditNote.legalMonetaryTotal.payableAmount" xmlns:cred40="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine" xmlns:cred41="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.creditedQuantity" xmlns:cred42="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.lineExtensionAmount" xmlns:cred43="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.pricingReference" xmlns:cred44="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.pricingReference.alternativeConditionPrice" xmlns:cred45="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.pricingReference.alternativeConditionPrice.priceAmount" xmlns:cred46="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.taxTotal" xmlns:cred47="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.taxTotal.taxAmount" xmlns:cred48="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.taxTotal.taxSubtotal" xmlns:cred49="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.taxTotal.taxSubtotal.taxableAmount" xmlns:cred50="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.taxTotal.taxSubtotal.taxAmount" xmlns:cred51="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.taxTotal.taxSubtotal.baseUnitMeasure" xmlns:cred52="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.taxTotal.taxSubtotal.taxCategory" xmlns:cred53="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.taxTotal.taxSubtotal.taxCategory.perUnitAmount" xmlns:cred54="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.taxTotal.taxSubtotal.taxCategory.taxScheme" xmlns:cred55="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.item" xmlns:cred56="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.item.description" xmlns:cred57="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.item.sellersItemIdentification" xmlns:cred58="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.item.standardItemIdentification" xmlns:cred59="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.item.standardItemIdentification.iD" xmlns:cred60="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.item.commodityClassification" xmlns:cred61="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.item.additionalItemProperty" xmlns:cred62="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.item.additionalItemProperty.usabilityPeriod" xmlns:cred63="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.price" xmlns:cred64="https://pe.edocnube.com/api/emision/ubl/creditNote.creditNoteLine.price.priceAmount" xmlns:ext="https://pe.edocnube.com/api/emision/extensiones">
   <soapenv:Header/>
   <soapenv:Body>
      <emis:EmitirNotaCredito>
         <emis:Clave>----------</emis:Clave>
         <emis:NotaCredito>
            <not:CreditNote>
               <cred:ID>FF11-4755</cred:ID>
               <cred:IssueDate>2026-03-27</cred:IssueDate>
               <!--Optional:-->
               <cred:IssueTime>11:17:00</cred:IssueTime>
               <!--Optional:-->
               <cred:Notes>
                  <!--Zero or more repetitions:-->
                  <cred1:Note>
                     <!--Optional:-->
                     <cred1:LanguageLocaleID>1000</cred1:LanguageLocaleID>
                     <cred1:Value>SESENTA Y DOS MIL QUINIENTOS CUARENTA DOLARES CERO CENTAVOS</cred1:Value>
                  </cred1:Note>
               </cred:Notes>
               <cred:DocumentCurrencyCode>USD</cred:DocumentCurrencyCode>
               <cred:DiscrepancyResponse>
                  <cred2:ResponseCode>01</cred2:ResponseCode>
                  <cred2:Descriptions>
                     <!--Zero or more repetitions:-->
                     <cred3:Description>Anulación de la operación</cred3:Description>
                  </cred2:Descriptions>
               </cred:DiscrepancyResponse>
               <cred:BillingReferences>
                  <!--Zero or more repetitions:-->
                  <cred4:BillingReference>
                     <cred4:InvoiceDocumentReference>
                        <cred5:ID>FV01-00107140</cred5:ID>
                        <cred5:DocumentTypeCode>01</cred5:DocumentTypeCode>
                     </cred4:InvoiceDocumentReference>
                  </cred4:BillingReference>
               </cred:BillingReferences>
               <cred:AccountingSupplierParty>
                  <cred8:Party>
                     <cred9:PartyIdentification>
                        <cred10:ID>
                           <cred11:SchemeID>6</cred11:SchemeID>
                           <cred11:Value>20606317663</cred11:Value>
                        </cred10:ID>
                     </cred9:PartyIdentification>
                     <!--Optional:-->
                     <cred9:PartyName>
                        <cred12:Name>CICSA PERU S.A.C.</cred12:Name>
                     </cred9:PartyName>
                     <cred9:PartyLegalEntity>
                        <cred13:RegistrationName>?</cred13:RegistrationName>
                        <!--Optional:-->
                        <cred13:RegistrationAddress>
                           <!--Optional:-->
                           <cred14:ID>150131</cred14:ID>
                           <!--Optional:-->
                           <cred14:AddressTypeCode>0000</cred14:AddressTypeCode>
                           <!--Optional:-->
                           <cred14:CitySubdivisionName>Lima</cred14:CitySubdivisionName>
                           <!--Optional:-->
                           <cred14:CityName>Lima</cred14:CityName>
                           <!--Optional:-->
                           <cred14:CountrySubentity>Lima</cred14:CountrySubentity>
                           <!--Optional:-->
                           <cred14:District>San Isidro</cred14:District>
                           <!--Optional:-->
                           <cred14:AddressLines>
                              <!--Zero or more repetitions:-->
                              <cred15:AddressLine>
                                 <cred15:Line>Calle 1 con calle 2</cred15:Line>
                              </cred15:AddressLine>
                           </cred14:AddressLines>
                           <!--Optional:-->
                           <cred14:Country>
                              <cred16:IdentificationCode>PE</cred16:IdentificationCode>
                           </cred14:Country>
                        </cred13:RegistrationAddress>
                     </cred9:PartyLegalEntity>
                  </cred8:Party>
               </cred:AccountingSupplierParty>
               <cred:AccountingCustomerParty>
                  <cred17:Party>
                     <cred18:PartyIdentification>
                        <cred19:ID>
                           <cred20:SchemeID>6</cred20:SchemeID>
                           <cred20:Value>20606317663</cred20:Value>
                        </cred19:ID>
                     </cred18:PartyIdentification>
                     <cred18:PartyLegalEntity>
                        <cred21:RegistrationName>CORPORATIVO</cred21:RegistrationName>
                     </cred18:PartyLegalEntity>
                  </cred17:Party>
               </cred:AccountingCustomerParty>
               <cred:PaymentTerms>
                  <!--Zero or more repetitions:-->
                  <cred27:PaymentTerm>
                     <cred27:ID>FormaPago</cred27:ID>
                     <cred27:PaymentMeansID>Credito</cred27:PaymentMeansID>
                     <!--Optional:-->
                     <cred27:Amount>
                        <cred28:Value>62540</cred28:Value>
                     </cred27:Amount>
                     <!--Optional:-->
                     <cred27:PaymentDueDate>2026-03-27</cred27:PaymentDueDate>
                  </cred27:PaymentTerm>
                  <cred27:PaymentTerm>
                     <cred27:ID>FormaPago</cred27:ID>
                     <cred27:PaymentMeansID>Cuota001</cred27:PaymentMeansID>
                     <!--Optional:-->
                     <cred27:Amount>
                        <cred28:Value>62540</cred28:Value>
                     </cred27:Amount>
                     <!--Optional:-->
                     <cred27:PaymentDueDate>2026-03-27</cred27:PaymentDueDate>
                  </cred27:PaymentTerm>
               </cred:PaymentTerms>
               <cred:TaxTotal>
                  <cred29:TaxAmount>
                     <cred30:Value>9540</cred30:Value>
                  </cred29:TaxAmount>
                  <cred29:TaxSubtotals>
                     <!--Zero or more repetitions:-->
                     <cred31:TaxSubtotal>
                        <cred31:TaxableAmount>
                           <cred32:Value>53000</cred32:Value>
                        </cred31:TaxableAmount>
                        <cred31:TaxAmount>
                           <cred33:Value>9540</cred33:Value>
                        </cred31:TaxAmount>
                        <cred31:TaxCategory>
                           <cred34:TaxScheme>
                              <cred35:ID>1000</cred35:ID>
                              <cred35:Name>IGV</cred35:Name>
                              <cred35:TaxTypeCode>VAT</cred35:TaxTypeCode>
                           </cred34:TaxScheme>
                        </cred31:TaxCategory>
                     </cred31:TaxSubtotal>
                  </cred29:TaxSubtotals>
               </cred:TaxTotal>
               <cred:LegalMonetaryTotal>
                  <cred36:PayableAmount>
                     <cred39:Value>62540.00</cred39:Value>
                  </cred36:PayableAmount>
               </cred:LegalMonetaryTotal>
               <cred:CreditNoteLines>
                  <!--Zero or more repetitions:-->
                  <cred40:CreditNoteLine>
                     <cred40:ID>10</cred40:ID>
                     <!--Optional:-->
                     <cred40:CreditedQuantity>
                        <cred41:UnitCode>EA</cred41:UnitCode>
                        <cred41:Value>1.000</cred41:Value>
                     </cred40:CreditedQuantity>
                     <cred40:LineExtensionAmount>
                        <cred42:Value>3000.00</cred42:Value>
                     </cred40:LineExtensionAmount>
                     <cred40:PricingReference>
                        <cred43:AlternativeConditionPrices>
                           <!--Zero or more repetitions:-->
                           <cred44:AlternativeConditionPrice>
                              <cred44:PriceAmount>
                                 <cred45:Value>3540.00</cred45:Value>
                              </cred44:PriceAmount>
                              <cred44:PriceTypeCode>01</cred44:PriceTypeCode>
                           </cred44:AlternativeConditionPrice>
                        </cred43:AlternativeConditionPrices>
                     </cred40:PricingReference>
                     <cred40:TaxTotal>
                        <cred46:TaxAmount>
                           <cred47:Value>540.00</cred47:Value>
                        </cred46:TaxAmount>
                        <cred46:TaxSubtotals>
                           <!--Zero or more repetitions:-->
                           <cred48:TaxSubtotal>
                              <cred48:TaxableAmount>
                                 <cred49:Value>3000.00</cred49:Value>
                              </cred48:TaxableAmount>
                              <cred48:TaxAmount>
                                 <cred50:Value>540.00</cred50:Value>
                              </cred48:TaxAmount>
                              <cred48:TaxCategory>
                                 <!--Optional:-->
                                 <cred52:Percent>18</cred52:Percent>
                                 <!--Optional:-->
                                 <cred52:TaxExemptionReasonCode>10</cred52:TaxExemptionReasonCode>
                                 <cred52:TaxScheme>
                                    <cred54:ID>1000</cred54:ID>
                                    <cred54:Name>IGV</cred54:Name>
                                    <cred54:TaxTypeCode>VAT</cred54:TaxTypeCode>
                                 </cred52:TaxScheme>
                              </cred48:TaxCategory>
                           </cred48:TaxSubtotal>
                        </cred46:TaxSubtotals>
                     </cred40:TaxTotal>
                     <!--Optional:-->
                     <cred40:Item>
                        <!--Optional:-->
                        <cred55:Descriptions>
                           <!--Zero or more repetitions:-->
                           <cred56:Description>GATEWAY INALAMBRICO</cred56:Description>
                        </cred55:Descriptions>
                        <!--Optional:-->
                        <cred55:SellersItemIdentification>
                           <!--Optional:-->
                           <cred57:ID>630481</cred57:ID>
                        </cred55:SellersItemIdentification>
                     </cred40:Item>
                     <cred40:Price>
                        <cred63:PriceAmount>
                           <cred64:Value>3000.00</cred64:Value>
                        </cred63:PriceAmount>
                     </cred40:Price>
                  </cred40:CreditNoteLine>
                  <cred40:CreditNoteLine>
                     <cred40:ID>20</cred40:ID>
                     <!--Optional:-->
                     <cred40:CreditedQuantity>
                        <cred41:UnitCode>EA</cred41:UnitCode>
                        <cred41:Value>1.000</cred41:Value>
                     </cred40:CreditedQuantity>
                     <cred40:LineExtensionAmount>
                        <cred42:Value>50000.00</cred42:Value>
                     </cred40:LineExtensionAmount>
                     <cred40:PricingReference>
                        <cred43:AlternativeConditionPrices>
                           <!--Zero or more repetitions:-->
                           <cred44:AlternativeConditionPrice>
                              <cred44:PriceAmount>
                                 <cred45:Value>59000.00</cred45:Value>
                              </cred44:PriceAmount>
                              <cred44:PriceTypeCode>01</cred44:PriceTypeCode>
                           </cred44:AlternativeConditionPrice>
                        </cred43:AlternativeConditionPrices>
                     </cred40:PricingReference>
                     <cred40:TaxTotal>
                        <cred46:TaxAmount>
                           <cred47:Value>9000.00</cred47:Value>
                        </cred46:TaxAmount>
                        <cred46:TaxSubtotals>
                           <!--Zero or more repetitions:-->
                           <cred48:TaxSubtotal>
                              <cred48:TaxableAmount>
                                 <cred49:Value>50000</cred49:Value>
                              </cred48:TaxableAmount>
                              <cred48:TaxAmount>
                                 <cred50:Value>9000.00</cred50:Value>
                              </cred48:TaxAmount>
                              <cred48:TaxCategory>
                                 <!--Optional:-->
                                 <cred52:Percent>18</cred52:Percent>
                                 <!--Optional:-->
                                 <cred52:TaxExemptionReasonCode>10</cred52:TaxExemptionReasonCode>
                                 <cred52:TaxScheme>
                                    <cred54:ID>1000</cred54:ID>
                                    <cred54:Name>IGV</cred54:Name>
                                    <cred54:TaxTypeCode>VAT</cred54:TaxTypeCode>
                                 </cred52:TaxScheme>
                              </cred48:TaxCategory>
                           </cred48:TaxSubtotal>
                        </cred46:TaxSubtotals>
                     </cred40:TaxTotal>
                     <!--Optional:-->
                     <cred40:Item>
                        <!--Optional:-->
                        <cred55:Descriptions>
                           <!--Zero or more repetitions:-->
                           <cred56:Description>GOLD SYSTEM</cred56:Description>
                        </cred55:Descriptions>
                        <!--Optional:-->
                        <cred55:SellersItemIdentification>
                           <!--Optional:-->
                           <cred57:ID>630481</cred57:ID>
                        </cred55:SellersItemIdentification>
                     </cred40:Item>
                     <cred40:Price>
                        <cred63:PriceAmount>
                           <cred64:Value>50000.00</cred64:Value>
                        </cred63:PriceAmount>
                     </cred40:Price>
                  </cred40:CreditNoteLine>
               </cred:CreditNoteLines>
            </not:CreditNote>
            <not:InfoAdicionalEDoc>
               <ext:NombreIntegracion>SOAP UI</ext:NombreIntegracion>
               <!--Optional:-->
               <ext:UsuarioTransaccionERP>jzambrano</ext:UsuarioTransaccionERP>
               <!--Optional:-->
               <ext:CodigoTransaccionERP>ERPNC2026</ext:CodigoTransaccionERP>
               <!--Optional:-->
               <ext:SecuencialERP>ERP02000001096</ext:SecuencialERP>
               <!--Optional:-->
               <ext:EmailReceptor>jose.zambrano@guru-soft.com</ext:EmailReceptor>
               <!--Optional:-->
               <ext:EmailResponsable>soporte.pe@guru-soft.com</ext:EmailResponsable>
               <!--Optional:-->
               <ext:Campo1>Campo1</ext:Campo1>
               <!--Optional:-->
               <ext:Campo2>Campo2</ext:Campo2>
               <!--Optional:-->
               <ext:Campo3>Campo3</ext:Campo3>
               <!--Optional:-->
               <ext:Campo4>Campo4</ext:Campo4>
               <!--Optional:-->
               <ext:Campo5>Campo5</ext:Campo5>
               <!--Optional:-->
               <ext:Campo6>Campo6</ext:Campo6>
               <!--Optional:-->
               <ext:Campo7>Campo7</ext:Campo7>
               <!--Optional:-->
               <ext:Campo8>Campo8</ext:Campo8>
               <!--Optional:-->
               <ext:Campo9>Campo9</ext:Campo9>
               <!--Optional:-->
               <ext:Campo10>Campo10</ext:Campo10>
            </not:InfoAdicionalEDoc>
         </emis:NotaCredito>
      </emis:EmitirNotaCredito>
   </soapenv:Body>
</soapenv:Envelope>
```

{% endtab %}

{% tab title="Response" %}
{% code title="" %}

```xml
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <EmitirNotaCreditoResponse xmlns="https://pe.edocnube.com/api/emision" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
         <Estado>2</Estado>
         <FechaAutorizacion>2026-05-13T11:25:52.000-05:00</FechaAutorizacion>
         <MensajeError>La Nota de Credito numero FF11-4755, ha sido aceptada</MensajeError>
      </EmitirNotaCreditoResponse>
   </s:Body>
</s:Envelope>
```

{% endcode %}
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://wikiedoc.guru-soft.com/pe/integraciones-y-servicios/soap/ejemplos/nota-de-credito.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
